概览

API 介绍

VisionCoder API：统一兼容 OpenAI、Anthropic、Gemini 协议

一个 API Key，三套协议

VisionCoder 通用智能体平台对外提供同一个 Base URL，同时兼容 OpenAI、Anthropic、Google Gemini 三套官方 API 协议。客户端不需要改 SDK，只把官方 SDK 的 Base URL 改成 VisionCoder 即可。

协议族	路径前缀	典型客户端
OpenAI 兼容	`/v1`	OpenAI SDK、Codex CLI、OpenCode
Anthropic 兼容	`/v1`	Anthropic SDK、Claude Code
Gemini 兼容	`/v1beta`	Gemini CLI、@google/generative-ai

https://coder.api.visioncoder.cn

https://coder.api.visioncoder.cn/v1

https://coder.api.visioncoder.cn/v1beta

所有端点（除 GET /v1/models 外）均需携带 API Key。

适用于 OpenAI / Codex / OpenCode 等客户端。

Authorization: Bearer YOUR_API_KEY

Claude Code 等 Anthropic SDK 客户端使用此请求头。

x-api-key: YOUR_API_KEY

API Key 在 API Key 管理页面创建，两种 Header 共用同一个 Key。

当前 33 个。下表是快照、会过期，代码里请用 GET /v1/models 取实时列表。

厂商	模型 ID
OpenAI	`gpt-5.5`、`gpt-5.4`、`gpt-5.4-mini`、`gpt-5.6-luna`、`gpt-5.6-sol`、`gpt-5.6-terra`、`gpt-5.3-codex-spark`、`codex-auto-review`
Anthropic	`claude-opus-5`、`claude-sonnet-5`、`claude-opus-4-8`、`claude-haiku-4-5-20251001`、`claude-fable-5`
xAI Grok	`grok-4.20-heavy`、`grok-4.20-expert`、`grok-4.20-auto`、`grok-4.20-fast`、`grok-4.3-fast`
开源 / 国产	`deepseek-v4-pro`、`deepseek-v4-flash`、`glm-5.2`、`glm-5.1`、`qwen3.6-35b-a3b`、`kimi-k2.6`、`minimax-m2.7`
图片 / 视频	`gpt-image-2`、`gemini-3-pro-image-preview`、`grok-imagine-image-pro`、`grok-imagine-image`、`grok-imagine-image-lite`、`grok-imagine-video`、`doubao-seedream-5-0-260128`、`doubao-seedream-4-5-251128`

Model List

GET /v1/models — 返回可用模型，无需鉴权

Chat Completions

POST /v1/chat/completions — OpenAI 兼容主端点

Responses

POST /v1/responses — OpenAI Responses 协议，GPT-5 系列推荐

Responses Compact

POST /v1/responses/compact — Codex CLI 压缩协议

Messages

POST /v1/messages — Anthropic Messages 兼容

Gemini generateContent

POST /v1beta/models/{model} — Gemini API 兼容

Image Generation

POST /v1/images/generations — 图片生成异步提交，OpenAI Images 兼容

Task Query

GET /v1/tasks/{task_id} — 图片生成任务结果查询

Video Generation

POST /v1/contents/generations/tasks — 提交 Ark Seedance 兼容的视频生成任务

Video Task Query

GET /v1/contents/generations/tasks/{id} — 查询视频状态和生成结果

所有上游协议端点（/v1/messages、/v1/responses、/v1/chat/completions、/v1/responses/compact、/v1beta/models/{model}、/v1/images/generations、/v1/tasks/{task_id}、/v1/contents/generations/tasks、/v1/contents/generations/tasks/{id}）均经过 RateLimiter 限速，频率以你的套餐为准。
服务端请求超时为 600 秒，长上下文 / 推理任务请适当延长客户端超时。
任务查询端点（GET /v1/tasks/{task_id}）超时为 60 秒；图片生成本身为异步任务，提交后通过任务查询获取结果，不受该超时影响。
GET /v1/models 不限速、不鉴权。

错误以 HTTP 状态码 + JSON Body 形式返回，沿用各客户端协议的官方错误结构：

{
  "error": {
    "type": "invalid_request_error",
    "message": "API key not provided"
  }
}

常见状态码：