API 参考

AIUV 暴露的 HTTP 端点 —— OpenAI 兼容 + Anthropic 原生 + 任务异步接口的速查。

AIUV 同时支持两套协议: OpenAI 兼容(在 /v1/* 下)和 Anthropic 原生(在 /v1/messages)。你用的客户端 / SDK 在哪一边,base URL 就指对应的位置即可。

鉴权

所有调用都必须在请求头里带 key。两种 header 等价:

Authorization: Bearer sk-YOUR_KEY    ← OpenAI 风格,默认
x-api-key:     sk-YOUR_KEY            ← Anthropic 风格

key 在控制台 → API Keys 页面创建/查看/重置。

OpenAI 兼容端点(`/v1/*`)

Method	Path	用途
POST	`/v1/chat/completions`	Chat
POST	`/v1/completions`	Legacy 文本补全
POST	`/v1/embeddings`	向量化
POST	`/v1/images/generations`	图像生成
POST	`/v1/images/edits`	图像编辑
POST	`/v1/audio/transcriptions`	语音转文本
POST	`/v1/audio/translations`	语音翻译
POST	`/v1/audio/speech`	文本转语音
POST	`/v1/responses`	OpenAI Responses API
GET	`/v1/models`	模型列表
GET	`/realtime`	WebSocket realtime

请求体、响应体、流式格式都和官方完全一致 —— 直接拿 openai SDK 的代码用就行。

Anthropic 原生端点

Method	Path	用途
POST	`/v1/messages`	Anthropic Messages API(Claude / Claude Code 走这条)

字段含义、SSE 事件类型(message_start / content_block_delta / message_delta / message_stop)、tool_use 结构都和 Anthropic 官方一致。

异步任务(视频生成、长操作)

部分模型(seedance 视频生成、kling 等)是异步任务模式:

Method	Path	用途
POST	`/v1/videos/generations`	创建视频任务,返回 `task_id`
GET	`/v1/videos/:task_id`	轮询任务状态

错误格式

{
  "error": {
    "type":    "invalid_request_error",
    "code":    "model_not_found",
    "message": "model 'foo' is not available"
  },
  "success": false
}

常见 status code:

Code	含义
401	key 无效 / 已禁用 / 已过期
403	quota 用完或当前分组无权访问该模型
404	路径不存在 / model_name 不存在
429	速率限制(每 key 默认 RPM 上限)
5xx	上游错误,请重试

流式行为

OpenAI 端点流式格式:data: {chunk}\n\n,以 data: [DONE]\n\n 结束
Anthropic 端点流式格式:event: <type>\ndata: {...}\n\n 系列事件
AIUV 不缓冲流,首字延迟 = 上游首字延迟 + 网络一跳

模型清单

curl https://aiuv.ai/api/pricing | jq '.data[] | .model_name'

或浏览器直接看模型页。

鉴权