'%20stroke-width='5'/%3e%3cpath%20d='M82.5%2029H56.9L26.8%2075.9C25.5%2078%2027%2080.8%2029.5%2080.8H62.3V99H78.2V80.8H93.2V66.8H78.2V48.9L62.3%2073.8H48.7L64.9%2048.3H82.5V29Z'%20fill='url(%23four)'/%3e%3cpath%20d='M93.2%2048.8C88.6%2045.1%2082%2043%2074.6%2043C62.9%2043%2054.8%2048.8%2054.8%2057.4C54.8%2066.2%2062.1%2069%2073.2%2070.6C81.8%2071.8%2084.8%2072.9%2084.8%2076.1C84.8%2079.5%2081.2%2081.4%2075.5%2081.4C68.8%2081.4%2063.7%2079.2%2059.2%2075.8L51%2087.1C56.5%2091.8%2065.2%2094.6%2075.1%2094.6C88.2%2094.6%2096.9%2088.4%2096.9%2075.8C96.9%2067%2090.2%2063.8%2078.1%2062.1C69.5%2060.9%2066.7%2059.9%2066.7%2056.8C66.7%2053.8%2069.8%2052.1%2074.7%2052.1C80%2052.1%2084.6%2053.8%2088.7%2057.1L93.2%2048.8Z'%20fill='%23F8FBFF'/%3e%3cpath%20d='M42%2099H86'%20stroke='%2334D399'%20stroke-width='5'%20stroke-linecap='round'/%3e%3cdefs%3e%3clinearGradient%20id='frame'%20x1='19'%20y1='18'%20x2='109'%20y2='112'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20stop-color='%2338BDF8'/%3e%3cstop%20offset='.52'%20stop-color='%2334D399'/%3e%3cstop%20offset='1'%20stop-color='%232563EB'/%3e%3c/linearGradient%3e%3clinearGradient%20id='four'%20x1='25'%20y1='29'%20x2='91'%20y2='99'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20stop-color='%23A7F3D0'/%3e%3cstop%20offset='.48'%20stop-color='%2338BDF8'/%3e%3cstop%20offset='1'%20stop-color='%232563EB'/%3e%3c/linearGradient%3e%3c/defs%3e%3c/svg%3e)
Gateway Protocols多标准协议兼容
OpenAIAnthropicGeminiOpenRouter
Chat / Responses / Messages / Claude MessagesBase URL
https://api.4stoken.cn鉴权方式
Authorization: Bearer sk-...计费入口
模型与价格实时展示交互式调用示例
POST /v1/chat/completions Base URL：https://api.4stoken.cn · 将 YOUR_API_KEY 替换为 Portal Client Key （sk-...）
本 Tab 支持stream
stream是否 SSE 流式返回（仅 Chat）
false（一次性 JSON）
max_tokens生成 token 上限
user message对话用户消息 content
curl -X POST 'https://api.4stoken.cn/v1/chat/completions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{"model":"your-model-code","messages":[{"role":"user","content":"Hello"}],"max_tokens":1024,"stream":false}'使用指南
展开查看鉴权、计费与扩展能力说明；接口参数与示例代码请用下方左侧导航切换。
鉴权
所有请求须携带 Header：Authorization: Bearer sk-...（在 Client Key 页创建，OpenAI 标准格式；历史 Key 可能为 sk-gw-...）。
Base URL
当前环境：
https://api.4stoken.cn与 Portal 文档引导接口返回一致；生产示例见模型与价格页。
计费
- 按 Token：输入 / 输出分别计价（见 模型与价格）
- 按次：图片等按调用次数
- 仅 HTTP 2xx 且业务成功后扣费；失败释放预扣
生图（OpenAI 标准接口）
- 文生图（OpenAI 标准）：
POST /v1/images/generations，JSON 仅prompt等；禁止image_urls（返回 400） - 图生图 / 关联生图（OpenAI 标准）：
POST /v1/images/edits，multipart/form-data上传image（可多张），不传 mask；Grsai 线路在网关内适配为上游generations + image[] - 局部重绘（mask）：同上
edits并上传mask；仅image_mask_enable=1线路（如 Rivo）。Grsai 对mask返回 400 - 同步出图（默认）：不传
async、无callbackUrl；HTTP 单次等待{ created, taskId, task_id, data[].b64_json }，taskId为返回给下游查询用的网关任务 ID - 异步出图：
async=true或callbackUrl→ 立即{ taskId, task_id, status: pending }，轮询GET /v1/images/tasks/{taskId} - 异步终态：任务完成后默认返回
{ created, taskId, task_id, data[].url }；若任务仍在处理中，仅返回taskId、task_id与status - 任务执行：客户端异步是 Gateway 侧任务能力；上游同步/异步差异由 Gateway 内部适配
视频生成（Seedance 官方协议）
- 提交任务：
POST /v1/videos，JSON 使用 Seedance 官方兼容字段，例如prompt、duration、aspect_ratio、resolution、image_url、reference_images。 - 任务查询：提交后返回 Gateway 本地
vid-...，轮询GET /v1/videos/{taskId}；查询也兼容部分上游任务 ID。 - 异步控制：
async=true或callbackUrl为 Gateway 扩展字段，只控制下游交互，不透传到 Seedance 官方上游。 - 成功结果：任务完成后按官方对外格式返回
{ task_id, taskId, status, data[].video_url }；若上游返回临时链接，Gateway 会先上传到 COS，再保存并返回我们的 COS URL。 - 统一链路：视频任务与异步图片共用网关任务模板、COS 写入/读取逻辑和 callbackUrl 投递语义。
流式
POST /v1/chat/completions 设 "stream": true 时返回 SSE（text/event-stream）。
- 响应为多条
data: {"object":"chat.completion.chunk",...}，末尾data: [DONE] - 网关对上游 chunk 原样转发（保留上游
id、model及finish_reason:null等字段） - 流式响应中不包含计费字段
billing；控制台请求日志中的response_body为台账 JSON，不能用来判断客户端实际收到的 SSE - 可用
stream_options: {"include_usage": true}，usage chunk 由上游原样透出
媒体 Webhook 回调通知（网关扩展）
POST /v1/images/generations、/v1/images/edits、/v1/videos 支持 callbackUrl 异步任务回传。
- 请求方式：网关向调用方传入的
callbackUrl发起POST，Body 为 JSON。 - 触发时机：图片 / 视频任务提交后接口立即返回
task_id；任务成功后投递，不等待回调接收方处理完成。 - 请求体：与对应任务查询成功响应一致，图片为
GET /v1/images/tasks/{taskId}，视频为GET /v1/videos/{taskId}；顶层包含task_id、taskId、status、data、usage等字段。 - 幂等建议：接收方使用
task_id去重；重复收到同一请求时返回成功即可。 - 接收约定：建议返回 HTTP 2xx 表示接收成功；非 2xx、超时或网络错误可能被视为投递失败。
- 安全建议：使用 HTTPS 私有回调地址，并在业务侧校验来源、路径随机串或自定义 token。
{ "created": 1710000000, "task_id": "vid-xxx", "taskId": "vid-xxx", "status": "succeeded", "data": [{ "video_url": "https://cos.example.com/gateway/video/result.mp4" }], "error": null }错误格式
标准接口失败时返回 JSON：
{ "error": { "message": "...", "type": "...", "code": "..." } }- 编辑器接入总览前置条件、19 个工具入口、三类接入目录、模型命名规则与 API 端点对照。
- Cursor 接入半自动向导、Override Base URL、Add Custom Model（spt-*）配置步骤。
- Claude Code 接入一键脚本、/v1/messages、sonnet/opus/haiku 模型映射与验证。
- Codex CLI 配置wire_api=responses、config.toml 写入与 openrouter-free profile。
- Codex Desktop 接入客户端内 Base URL、API Key 与模型配置；不需要 Node.js。
使用 Claude Code / Codex / Cursor？ 前往编程工具接入 → · 需要完整 Schema？
GET /v1/models
模型列表
获取当前 Client Key 可用的模型列表。
接口信息
请求地址
https://api.4stoken.cn请求路径
/v1/models请求方式
GETContent-Type
无请求体鉴权
Authorization: Bearer sk-...输入参数
无请求体，仅需传入鉴权 Header。
输出参数
| 参数 | 类型 | 返回 | 说明 |
|---|---|---|---|
object | string | 是 | 固定为 list。 |
data[].id | string | 是 | 模型编码，调用其它接口时传入 model。 |
data[].object | string | 是 | 固定为 model。 |
data[].owned_by | string | 否 | 模型归属标识。 |
错误代码
| HTTP 状态码 | 错误 | 说明 |
|---|---|---|
401 | Unauthorized | Client Key 无效或未提供。 |
示例
响应示例
{
"object": "list",
"data": [
{
"id": "gpt-4.1",
"object": "model",
"owned_by": "ai-gateway"
}
]
}