快速开始

OpenAI compatible. Drop in with 3 lines of code.

1. Get API 密钥

登录 AICraft Console，进入「API 密钥s」创建密钥。格式：sk-aicraft + hex。

2. 基础地址

3. First Call

复制curl https://aicraftapi.com/v1/chat/completions   -H "Content-Type: application/json"   -H "Authorization: Bearer YOUR_API_KEY"   -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'

复制# pip install openai
from openai import OpenAI
client = OpenAI(api_key="YOUR_API_KEY", base_url="https://aicraftapi.com/v1")
response = client.chat.completions.create(model="auto", messages=[{"role":"user","content":"Hello!"}])
print(response.choices[0].message.content)

复制// npm install openai
import OpenAI from "openai";
const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://aicraftapi.com/v1" });
const r = await client.chat.completions.create({ model: "auto", messages: [{ role: "user", content: "Hello!" }] });
console.log(r.choices[0].message.content);

复制// go get github.com/openai/openai-go
package main
import ("context"; "fmt"; openai "github.com/openai/openai-go"; "github.com/openai/openai-go/option")
func main() {
    c := openai.NewClient(option.WithAPIKey("YOUR_API_KEY"), option.WithBaseURL("https://aicraftapi.com/v1"))
    r, _ := c.Chat.Completions.New(context.Background(), openai.ChatCompletionNewParams{
        Model: openai.String("auto"),
        消息s: openai.F([]openai.ChatCompletion消息ParamUnion{openai.User消息("Hello!")}),
    })
    fmt.Println(r.Choices[0].消息.Content)
}

下载工具

Pair these Tool, maximize your AICraft Usageexperience.

VS Code

Claude Code SetupGuides

Claude Code 是 Anthropic 的终端 AI 编程工具。以下演示如何接入 AICraft。

1. Install Claude Code

前提：Node.js 18+（推荐 Node.js 22).

复制# Anthropic official  native installer (recommended)
curl -fsSL https://claude.ai/install.sh | bash

# or via  npm (fallback)
npm install -g @anthropic-ai/claude-code

# Verify Install
claude --version

复制:: Windows RecommendedUsage WSL, then run:
curl -fsSL https://claude.ai/install.sh | bash

:: 或直接在 Windows 上用 npm（需先装 Node.js）
npm install -g @anthropic-ai/claude-code

also Usageone-click script: Download Installscript

2. Get API 密钥

登录 AICraft Console → API 密钥s → 创建 Key。

3. Configure settings.json

创建或编辑 settings.json：

复制mkdir -p ~/.claude && touch ~/.claude/settings.json

复制New-Item -ItemType Directory -Force -Path "$HOME\.claude" | Out-Null
New-Item -ItemType File -Force -Path "$HOME\.claude\settings.json" | Out-Null

写入以下配置（替换 YOUR_API_KEY）：

复制{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aicraftapi.com/v1",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "auto",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "auto",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "auto",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "auto",
    "CLAUDE_CODE_SUBAGENT_MODEL": "auto"
  }
}

4. Verify

Open a new terminal, cd to your project:

cd your-project
claude

After startup, type /status：API Endpoint should be aicraftapi.com/v1，Model should be auto。

5. with VS Code Usage（Vibe Coding）

VS Code 打开项目 → Ctrl+` 打开终端 → 输入 claude。AI 生成的代码实时出现在编辑器中。

6. Enable Deep Reasoning

在 Claude Code 中输入 /config，将 Thinking mode 设为 true。退出重新进入生效。

常见问题

配置后 Web Search 能用吗？

能用。AICraft 不禁用 Claude Code 的原生搜索。如需接入 MCP 搜索服务，参考 腾讯云 MCP 市场。

model: "auto" 会选什么模型？

Router picks per task: DeepSeek for coding, Qwen for Chinese, MiniMax for creative. Check X-AICraft-Routed-To header. See Auto Router。

技能包

74 个 AI 开发技能，覆盖编码、测试、部署、安全、文档全流程。下载后导入到 Claude Code 中直接调用。

安装

解压到 Claude Code 的 skills 目录：

复制# 1. Download and extract
unzip aicraft-skills.zip -d ~/.claude/skills/

# 2. Verify 
ls ~/.claude/skills/
# Should see 74 directories (python / fastapi / code-review ...)

复制:: 1. Download aicraft-skills.zip
:: 2. Extract to %USERPROFILE%\.claude\skills::    Right-click zip -> Extract to .claude\skills

:: 3. PowerShell verify
dir $env:USERPROFILE\.claude\skills\

使用

在 Claude Code 中输入 /skill-name 即可调用。例如：

复制/python-patterns        # 获取 Python 设计模式指导
/code-review            # Reviewcurrent code
/test-driven-development # TDD 开发流程
/deployment-strategies   # 部署策略建议
/security               # SecurityReview
/api-design             # API 设计最佳实践

API 参考

Chat Completions

OpenAI 兼容的对话补全端点。

请求参数

响应格式

复制{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1720000000,
  "model": "deepseek-chat",
  "choices": [{
    "message": { "role": "assistant", "content": "Hello! How can I help?" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 10, "completion_tokens": 8, "total_tokens": 18 }
}

流式响应 (SSE)

设置 "stream": true：

复制data: {"choices":[{"delta":{"content":"Hello"}}]}

data: {"choices":[{"delta":{"content":" world"}}]}

data: {"choices":[{"finish_reason":"stop"}]}

data: [DONE]

Each chunk is data: {json}. Ends with data: [DONE]. OpenAI SDK handles this.

模型列表

列出可用模型。完整列表和定价见 模型目录。

复制curl https://aicraftapi.com/v1/models -H "Authorization: Bearer YOUR_API_KEY"

智能路由 v6

model: "auto" 即启用 AICraft 核心路由引擎。

6 Routing Categories

Response Headers

v6 智能特性

• 锁定衰减 — 7 days idle, Taskauto-unlockModelpreference
• 分布偏移检测 — Tasktype shift > 40% auto-unlock
• 故障自愈 — 1 小时内故障模型自动扣分并绕过
• 社区冷启动 — 新用户参考社区偏好获得高质量路由
• 反馈接口 — POST /v1/feedback 帮助 Router 学习你的偏好

指南

响应缓存 beta

双层缓存自动省钱。对调用方完全透明。当前逐步上线中。

• 命中率：35-55% · 容量：50,000 条 · TTL：1 小时 · user_id 隔离
• 自动生效。跳过：X-AICraft-No-Cache: true
• 统计：GET /cache-stats

速率限制

超出限制返回 429。详见 定价页。

错误码

OnlineDebug