CLI 接入
让本地 Agent 使用 奇画 AI
把你电脑上的 Claude Code / Codex / OpenCode 等编码 Agent 接到 奇画 AI: 只需把它的 base URL 指向 奇画 AI 的 OpenAI / Anthropic 兼容端点, 用一个 API Key 鉴权。 无需改配置文件, Agent 即可直接调用这里的全部对话模型与媒体生成, 按统一额度计费。
一分钟接入
选择你的工具, 复制下面的命令, 把占位符换成你的 API Key。
Anthropic 原生协议, 走 /v1/messages。效果以 Claude 模型为准, 其他模型经协议转换, 不保证工具调用效果。
bash
# Claude Code -> https://qihuaai.com
export ANTHROPIC_BASE_URL="https://qihuaai.com"
export ANTHROPIC_AUTH_TOKEN="qh_你的APIKey"
export ANTHROPIC_MODEL="<登录后自动填入 Claude 型号>"
export ANTHROPIC_DEFAULT_OPUS_MODEL="<登录后自动填入 Claude 型号>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="<登录后自动填入 Claude 型号>"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="<登录后自动填入 Claude 型号>"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude还没有 API Key? 在密钥管理里创建一个 (明文只显示一次)。创建 API Key
说明
- • 端点: 对话用
https://qihuaai.com/v1/chat/completions(OpenAI 兼容) 或https://qihuaai.com/v1/messages(Anthropic 兼容), Codex 用https://qihuaai.com/v1/responses(OpenAI Responses)。 - • 模型名见 创作页 或 开发文档; 媒体生成见
https://qihuaai.com/v1/media/generate。 - • Claude Code 的型号变量取自当前上架的 Claude 模型; 也支持
ANTHROPIC_API_KEY(x-api-key) 方式鉴权。 中途中断 (Ctrl+C) 时上游仍会生成完整回复, 按上游实际用量计费 (含推理部分), 预扣的差额自动退回。 - • Claude 模型单次输入超过约 200k tokens 会被拒绝 (400, reason=context_too_long), 不扣费. /v1/messages 不支持 Anthropic 服务端工具 (web_search, code_execution), mcp_servers 以及 1M 上下文 / fast mode 等 beta, 这些字段会被忽略; cache_control 的 1 小时 TTL 会降为 5 分钟.
- • 实际用量超过预扣且余额不足时, 差额记为欠费, 付费调用会被暂停, 充值补足欠费后自动恢复.
- • 可在密钥设置里给 Key 锁定模型白名单 / 线路 / 每日额度, Agent 的消耗与网页端共用同一钱包。
- • 额度与计费完全透明: 每次调用在 用量 和 账单 可查。