API 参考/接口与请求示例

接口与请求示例

Wokey 兼容 OpenAI 与 Anthropic 的接口格式。这里列出全部公开接口，并给出三种文本格式的请求示例。

本页内容expand_more

接口列表link

POST/chat/completionsChat Completions

OpenAI Chat Completions 兼容格式，适合大多数 OpenAI SDK 和聊天客户端。

POST/responsesResponses

OpenAI Responses 兼容格式，Codex CLI 推荐使用这个协议。

POST/messagesMessages

Anthropic Messages 兼容格式，适合 Claude Code 和 Anthropic SDK。原生 Messages 请求必须携带 max_tokens；OpenAI 风格请求建议使用 /chat/completions。

POST/images/generationsImage Generations

OpenAI Images 兼容格式，当前支持 gpt-image-2.5（旧别名 gpt-image-2 仍兼容）。和文本 API 不同，图片请求有独立的 size、响应格式和按图计费规则。 查看说明 →

POST/v1/videosVideo Generations

异步视频生成接口。提交后返回任务 ID，再通过查询接口轮询状态并下载成片。 查看说明 →

GET/modelsModels

默认返回当前可用的文本模型；可用 output_modalities=image、video 或 all 发现当前可调用的媒体模型。

GET/v1/models/pricingModel Pricing

统一返回当前可调用的文本、图片和视频模型价格；支持按输出模态或精确模型 ID 筛选。

GET/v1/images/modelsImage Models

返回当前可调用的图片模型、支持参数、尺寸范围与按图价格档位。

GET/v1/videos/modelsVideo Models

返回当前至少有一个可售规格的视频模型，以及模式、分辨率、时长、比例与每秒价格。

路径写法link

网关也兼容 /v1/chat/completions、/v1/responses、/v1/messages、/v1/images/generations、/v1/models 路径。视频生成使用 /v1/videos。

请求示例link

OpenAI Chat Completions

cURL
curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

OpenAI Responses

cURL
curl https://api.wokey.ai/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "instructions": "You are a helpful assistant.",
    "input": [
      { "role": "user", "content": "Hello" }
    ],
    "store": false,
    "stream": false
  }'

Anthropic Messages

cURL
curl https://api.wokey.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'