接入文档
一把 Key，接通 Claude、GPT 与主流国产模型
兼容 OpenAI 与 Anthropic 官方协议，现有代码只改地址和 Key 两项。先选择你的使用方式：
开始 · 个人
三步开始
注册、充值、新建 Key，三步之后就能在工具里用。
- 1注册：用邮箱、Google 或 GitHub 注册，注册即送体验额度。
- 2充值：控制台 → 钱包，扫码充值，按人民币计，首充有额外赠送。
- 3新建 Key：控制台 → API 密钥 → 新建，分组选 「自动」，一把 Key 即可调用全部模型。
下一步 → 在工具里用
开始 · 企业
开通流程
先判断是「企业直连」还是「代理分发」，然后四步开通。
| 企业直连 | 代理分发 | |
|---|---|---|
| 谁在调用 | 你自己的产品或内部系统 | 你的终端客户（你是平台方） |
| 你获得 | 企业专属分组与价格、调用 Key | 另加 Partner API：为每个客户发 Key、设额度、单独对账 |
| 接着读 | 接入 → 计费 → 上线前检查 | 同左，再加代理分发 |
- 1联系商务，签订服务协议
- 2对公转账预充值，支持人民币、美元、港币，可开发票
- 3我们开通企业账户，交付 Key；代理分发另交付管理凭证与接口契约
- 4修改两项配置完成接入；按月或按周对账
下一步 → 联系我们开户
接入
地址与鉴权
按协议填地址：OpenAI 兼容要带 /v1，Anthropic 兼容填根域名。
| 协议 | 适用 | Base URL | 鉴权头 |
|---|---|---|---|
| OpenAI 兼容 | GPT、Gemini、国产文本、图片 | https://api.waytocc.com/v1 | Authorization: Bearer <Key> |
| Anthropic 兼容 | Claude、Claude Code | https://api.waytocc.com | x-api-key: <Key> |
/v1，OpenAI SDK 则要求 Base URL 已带 /v1。调 Claude 请走 Anthropic 协议（/v1/messages）：用 OpenAI 兼容的 /v1/chat/completions 也能调通，但请求里带不了缓存标记，提示缓存不会命中，输入每次按全价计费。工具里如果只有 OpenAI 兼容选项，地址只填到 /v1，工具会自己补 /chat/completions；填成 /v1/messages 会被补成 /v1/messages/chat/completions，返回 404。接入
在工具里用
先选你用的是桌面端、命令行还是插件，再照那一种的步骤做。
Claude Code · Codex
Claude Code 与 Codex 现在都并入了各自的桌面端（Claude 桌面端、ChatGPT 桌面端），命令行仍然独立。选好之后，只看你那一种的步骤。
三种读配置的位置各不相同，选错了会一直要求登录。
- 1
打开开发者模式
在 Claude 桌面端的菜单里选 Help → Troubleshooting → Enable Developer Mode，应用会自动重启。
- 2
填写网关
重启后选 Developer → Configure Third-Party Inference，按下面填写并保存。桌面端只认这里的设置，不读环境变量，也不读
settings.json。Configure Third-Party InferenceInference provider : Gateway Base URL : https://api.waytocc.com API key : YOUR_API_KEY Credential kind : Static API key Auth scheme : Bearer - 3
重启并开始使用
彻底退出 Claude 桌面端再打开，进入 Code 发一条消息。接入网关后，云端环境和 Remote Control 不可用。
›连不上怎么办
- 仍然要求登录
- 配置没有被读到。桌面端、命令行、VS Code 插件各读各的位置，请确认你改的是当前这一种。
- 404
- 地址填
https://api.waytocc.com，不要带/v1。 - 401
- Key 没有复制完整；桌面端的 Auth scheme 要选 Bearer。
- 400
- 先把 Claude Code 升级到最新版再试，旧版本发出的个别字段会被拒绝。
Cherry Studio · Cline
Cherry Studio、Cline 等客户端：新建模型服务商，类型选 OpenAI 时地址填 https://api.waytocc.com/v1，选 Anthropic 时填 https://api.waytocc.com；填入 Key，模型名从模型广场复制。 登录后在模型广场查看
接入
在代码里用
沿用官方 SDK，只改 api_key 与 base_url。示例里的 YOUR_API_KEY 换成你的 Key。
# pip install openai
from openai import OpenAI
client = OpenAI(
base_url="https://api.waytocc.com/v1", # 指向 WaytoCC（带 /v1）
api_key="YOUR_API_KEY",
)
stream = client.chat.completions.create(
model="gpt-5.6-sol",
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="", flush=True)返回格式与官方一致：OpenAI 协议的文本在 choices[0].message.content（流式在 delta.content），Anthropic 协议在 content[0].text。
能力
文本
Claude、GPT、Gemini 与国产旗舰，能力与官方一致。长回答请开流式。
有哪些模型
| 系列 | 型号 | 协议 |
|---|---|---|
| Claude | Fable、Opus、Sonnet、Haiku 系列 | Anthropic 兼容 |
| GPT | GPT-6.1、GPT-6、GPT-5.6 系列 | OpenAI 兼容 |
| Gemini | Gemini 3.8 Flash、Gemini 4 Argon | OpenAI 兼容；也可用 google-genai 原生 SDK |
| 国产 | DeepSeek V4 / V4.1、Kimi K3、GLM 5.3 / 5.2、Qwen3.8 Max | OpenAI 兼容 |
完整型号与你的价格，登录后在模型广场查看；程序可用 GET /v1/models 获取。 登录后在模型广场查看
怎么调用
- 对话：示例见「在代码里用」。
- 流式输出：设
stream: true；OpenAI 协议建议同时传stream_options: {"include_usage": true}，最后一个事件会带上用量。非流式的长回答超过约 100 秒可能被网关中断（524）。 - 工具调用、多模态、prompt caching：与官方用法一致。
# pip install openai
from openai import OpenAI
client = OpenAI(
base_url="https://api.waytocc.com/v1", # 指向 WaytoCC（带 /v1）
api_key="YOUR_API_KEY",
)
resp = client.chat.completions.create(
model="deepseek-v4-pro", # kimi-k3 / glm-5.3 / qwen3.8-max / gemini-3.8-flash …
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)POST https://api.waytocc.com/v1/chat/completions
Authorization: Bearer YOUR_API_KEY
请求示例
curl -sS -X POST https://api.waytocc.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [
{
"role": "user",
"content": "请用三句话介绍自己。"
}
],
"stream": true
}'非流式文本在 choices[0].message.content；流式读取 choices[].delta.content。
参数说明
对话内容
- 模型型号必填
model gpt-5.6-sol使用模型广场中的完整型号；切换模型时确认该型号支持当前接口。
- 用户输入必填
messages 传消息数组，例如 [{"role":"user","content":"你好"}]。多轮对话按顺序加入 user / assistant 消息。
- 系统指令可选
messages[].role 可选，可用 system 消息指定回答规则；部分推理型号使用 developer 角色，按该型号要求选择。
输出设置
- 流式输出可选
stream truefalse默认：false
true 会逐段返回内容，适合长回答；false 等完整结果后返回 JSON。
流式结果是 SSE 事件，不能把整个响应当作一个 JSON 解析。
- 输出长度上限可选
max_completion_tokens 正整数，例如 1024单位为 token，不是字数。不能超过当前型号的输出上限；推理型号的预算可能包含推理 token。
这三个协议的长度字段不同，请使用这里显示的字段。
- 流式用量统计可选
stream_options.include_usage true使用 stream=true 时，可请求在最后一个事件返回用量。仅对支持该选项的型号使用。
按型号启用的高级参数
- 随机性可选
temperature / top_p 可选，temperature 控制随机性，top_p 控制候选范围。通常只调整其中一个；取值范围依型号而定。
部分推理型号不接受这两个参数或只接受默认值，未确认支持时请省略。
- 推理强度可选
reasoning_effort lowmediumhigh仅支持推理设置的型号可用。更高强度可能增加推理用量和等待时间；可选档位随型号变化。
- 工具调用可选
tools / tool_choice 可选，为支持工具调用的型号定义工具并控制选择。需要在客户端执行工具，并将结果继续发回模型。
Chat 函数工具使用 {"type":"function","function":{"name":...,"parameters":...}}；tool_choice 可设 auto。
- 结构化输出可选
response_format 仅支持该能力的型号可用。JSON Schema 可约束输出结构；Responses 使用 text.format，Chat 使用 response_format。
示例："response_format":{"type":"json_schema","json_schema":{"name":"result","schema":{...},"strict":true}}。
- 服务档位可选
service_tier / speed 通常不需要指定。部分型号不支持这些参数，传入会返回 400；除非确认型号支持，否则省略。
GPT 系列传 priority 或 fast（即 Codex 的 Fast 模式）时响应更快，并按 Fast 价计费：标准价的 2 倍。
能力
图片
单张用同步接口；批量或耗时长的用异步接口：先提交，再轮询。
gpt-image-2、gpt-image-2.5 系列（flare / sunburst）、Seedream 5.0 Pro。模型名必须完整，注意是 gpt-image-2（带 -2）。
| 方式 | 接口 | 说明 |
|---|---|---|
| 文生图 | POST /v1/images/generations | GPT Image 与 Seedream Pro；JSON，同步返回 |
| 修改图片 | POST /v1/images/edits | 仅 GPT Image；multipart，上传 image 文件 |
| 异步出图 | POST /v1/images/async → GET /v1/images/async/{id} | 仅 GPT Image 文生图；保存 id 后查询结果 |
POST https://api.waytocc.com/v1/images/generations
Authorization: Bearer YOUR_API_KEY
使用自动分组（Auto）密钥可覆盖所有示例。固定 image 分组的同步接口仅支持不指定尺寸、质量等参数的基础 gpt-image-2；带参数的同步生图、2.5 同步生图或改图请用 Auto。
请求示例
curl -sS -m 660 -X POST https://api.waytocc.com/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "白色背景上的陶瓷茶杯产品照，自然光，细节清晰。",
"n": 1,
"size": "1024x1024",
"response_format": "b64_json"
}'同步调用建议设置 660 秒客户端超时；耗时长的文生图可用异步接口。超时后先核对用量记录，避免重复提交和扣费。成功后解码 data[].b64_json 保存图片；修改图片时，将 input.png 换成自己的文件。
参数说明
生成什么
- 模型型号必填
model gpt-image-2复制完整型号名。不同型号的参数和价格可能不同。
- 画面描述必填
prompt 支持中文。描述主体、场景、风格，以及需要保留或修改的细节。
输出规格
- 图片尺寸可选
size 1024x10241024x15361536x10242048x2048auto1024x1024 方形；1024x1536 竖图；1536x1024 横图；auto 由模型选择。实际输出尺寸可能与请求不同。
自定义宽、高须为 16 的倍数，每边 256 到 4096 像素。1920x1080 不符合要求，可用 1824x1024；不能传 1K 或 2K。
- 生成张数可选
n 1 到 4，整数默认：1
例如 n=2 生成两张；数量增加会增加费用。
- 生成质量可选
quality lowmediumhighauto默认：省略时由服务选择
low 较快；medium 均衡；high 细节更多；auto 自动选择。质量档位会影响费用。
价格中的 default 表示没有指定 quality，不要发送 "default"。
- 结果返回方式可选
response_format b64_json默认：b64_json
读取 data[].b64_json，Base64 解码后写入图片文件。同步 url 的可用性取决于当前路由，建议用 b64_json。
高级参数与限制
- 图片文件格式可选
output_format pngjpeg这是图片文件的编码格式，与 response_format 的返回方式不同。不支持 webp 输出。
- 背景可选
background transparentopaqueautotransparent 透明，opaque 不透明，auto 自动。透明背景建议使用 PNG。
- 压缩质量可选
output_compression 0 到 100，整数控制压缩质量，通常与 JPEG 输出一起使用。
GPT Image · SDK 示例
curl -sS -m 660 https://api.waytocc.com/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "a red panda eating bamboo, studio lighting",
"n": 1,
"response_format": "b64_json"
}' \
| python3 -c "import sys,json,base64; d=json.load(sys.stdin); open('out.png','wb').write(base64.b64decode(d['data'][0]['b64_json'])); print('saved out.png')"同步示例使用 660 秒客户端超时。慢请求可能超过 3 分钟；耗时长的文生图建议使用异步接口。同步超时后先核对用量记录，避免重复提交和扣费。
GPT Image · 修改图片
curl -sS -m 660 https://api.waytocc.com/v1/images/edits \
-H "Authorization: Bearer YOUR_API_KEY" \
-F model=gpt-image-2 \
-F [email protected] \
-F prompt="put the subject in a snowy forest at night" \
-F response_format=b64_json \
| python3 -c "import sys,json,base64; d=json.load(sys.stdin); open('out.png','wb').write(base64.b64decode(d['data'][0]['b64_json'])); print('saved out.png')"仅适用于 GPT Image。把 input.png 换成自己的图；Seedream Pro 的参考图放在 generations 请求的 image 字段中。
异步出图
GPT Image 出图慢（1 到 4 分钟）又怕连接超时时可用异步；Seedream Pro 不支持此接口。提交时使用原型号，不需要加 -async 后缀。
# 1. 提交任务，立刻返回任务 id
curl -sS -X POST https://api.waytocc.com/v1/images/async \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "a red panda eating bamboo, studio lighting",
"n": 1,
"size": "1024x1024",
"quality": "high"
}'
# → {"id":"TASK_ID","object":"image.task","status":"queued","model":"gpt-image-2","created_at":1781184210}
# 2. 每 5 秒查一次，succeeded 后取 data[].url
curl -sS https://api.waytocc.com/v1/images/async/TASK_ID \
-H "Authorization: Bearer YOUR_API_KEY"
# 3. 下载图片（链接 24 小时内有效）
curl -sS -o out.png "IMAGE_URL"status 依次为 queued → running → succeeded / failed，建议每 5 秒轮询一次。succeeded 时返回 data: [{url}] 和 usage；failed 时返回 error。
异步只做文生图：不支持改图，也不支持 response_format=b64_json，结果一律是链接。计费与同步相同：提交时先预扣估算额，完成后多退少补，失败全额退回。
›参数与返回
GPT Image 同步示例返回 data[].b64_json，Base64 解码后写入文件；异步结果和 Seedream Pro 示例读取 data[].url 下载图片。实际尺寸可能与请求不同，计费以实际输出为准。
{
"created": 1781184210,
"data": [
{ "b64_json": "iVBORw0KGgoAAAANSUhEUg..." }
],
"usage": {
"input_tokens": 8,
"output_tokens": 0,
"total_tokens": 8
}
}能力
视频
先提交、再轮询；预留 15 分钟；下载链接约 24 小时后失效，请立即转存。
有哪些模型
| 模型 | 分辨率 | 时长 |
|---|---|---|
| doubao-seedance-2.0 | 480p / 720p / 1080p / 4K | 4–15 秒 |
| doubao-seedance-2.5 | 480p / 720p / 1080p | 4–15 秒 |
| doubao-seedance-2.0-fast / -mini | 480p / 720p | 4–15 秒 |
| kling/kling-v3-video-generation / kling-v3-omni-video-generation | 720p / 1080p / 4k（默认 720p） | 3–15 秒，默认 5 秒 |
| kling/kling-v3-turbo-video-generation | 720p / 1080p（默认 720p） | 3–15 秒，默认 5 秒 |
| happyhorse-1.1-t2v / -i2v / -r2v | 720P / 1080P（默认 1080P） | 3–15 秒，默认 5 秒 |
| MiniMax-H3 | 480p / 720p / 1080p / 2K（默认 720p） | 4–15 秒，默认 5 秒 |
参数不合法时，错误信息会列出该模型允许的取值。旧型号名 seedance-cn-* 仍可调用，对应同名新型号。
怎么调用
按模型选择下面的调用示例。Seedance 示例使用专用接口，轮询到 succeeded 后从 result.data[0].url 下载；其他示例使用统一接口 POST /v1/videos，轮询到 completed 后从 /content 下载。
curl -sS -X POST https://api.waytocc.com/video-domestic/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-2.0-mini",
"input": {
"prompt": "一只橘猫在窗台上伸懒腰"
},
"parameters": {
"resolution": "480p",
"duration": 4,
"ratio": "16:9",
"generate_audio": false
}
}'
curl -sS https://api.waytocc.com/video-domestic/v1/video/generations/TASK_ID \
-H "Authorization: Bearer YOUR_API_KEY"
# result.data[0].url
curl -sSL "$VIDEO_RESULT_URL" -o video.mp4doubao-seedance-2.0，传 parameters.resolution: 4k；Fast、Mini 和 2.5 不开放 4K。可灵用 settings.aspect_ratio 设置比例，Turbo 所有音频选项均按有声档计费。HappyHorse 始终生成音频；图生视频用 input_reference，多图参考用 images 数组。分辨率名称代表所选档位，实际视频尺寸可能略有不同。MiniMax-H3 的 480p / 720p / 1080p 支持带素材生成：input_reference 传首帧，images 数组依次传首帧和尾帧；参考图用 metadata.reference_images，参考音频用 metadata.reference_audios，参考视频用 metadata.reference_videos，三者都是数组，合计最多 9 个。素材必须是公网 https 地址；首尾帧不能和参考素材混用；参考视频总时长约 10 秒以内，超出会生成失败并全额退回。带图、带音频与文生视频同价；参考图超过 5 张后每张另计；参考视频按输入秒数、以同档每秒价另计——提交时先按 15 秒预扣，出片后按实际秒数结算并退回差额。单价见模型广场。实测 4 秒 480p 约 3–4 分钟出片，分辨率和时长越高越久，客户端预算请留够 15 分钟；建议 10 秒轮询一次。
提交时预扣费用，任务失败自动全额退回，成功后按实际规格结算。
Kling V3：参数与价格档位
720p-silent 等名称是价格档位，不是请求字段。无声档设置 settings.audio: off，有声档设置 native，4K 设置 settings.resolution: 4k。动作控制必须传 action: motion_control 和主体图片、动作视频；Omni 参考视频使用 contents，且音频为 off。下方示例按型号和档位生成。
settings.resolution = "720p" · settings.audio = "off"
请求示例
curl -sS -X POST https://api.waytocc.com/v1/videos \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling/kling-v3-video-generation",
"prompt": "A ceramic cup on a table, slow camera push-in, natural light.",
"settings": {
"resolution": "720p",
"duration": 5,
"audio": "off",
"aspect_ratio": "16:9"
}
}'参数说明
生成什么
- 模型型号必填
model kling/kling-v3-video-generation使用完整型号名。标准版、Turbo 和 Omni 是不同模型。
- 画面描述必填
prompt / contents[].text 用 1 到 2500 个字符描述主体、动作、镜头和风格。
文生视频传顶层 prompt；使用 contents 时，放一条 {"type":"prompt","text":"你的描述"}，不再传顶层 prompt。
- 生成方式可选
action text_to_videoimage_to_videomotion_control默认：按素材自动选择
无素材时为文生视频，有首帧图时为图生视频。
动作控制必须显式传 motion_control，并提供一张图片和一段动作视频。
输出规格
- 画质可选
settings.resolution 720p1080p4k默认：720p
分辨率越高，价格通常越高；以当前价格档位为准。
4k 必须小写；动作控制仅支持 720p 和 1080p。
- 视频时长可选
settings.duration 3 到 15 秒，整数默认：5 秒
例如 8 表示 8 秒。也可传顶层 seconds；两处同时填写时必须一致。
- 画面比例可选
settings.aspect_ratio 16:99:161:1默认：16:9
16:9 横屏，9:16 竖屏，1:1 方形。
- 声音可选
settings.audio offnativeoriginal默认：off
off：无声；native：生成音频；original：使用原音频。
动作控制默认 original。有声与无声档位价格不同；4K 以统一档位为准。
参考素材
- 素材角色与地址按模式必填
contents[].type / url first_framelast_frameimagevideo图生视频需要 first_frame，可加 last_frame 尾帧。动作控制需要 image 主体图和 video 动作视频。尾帧必须搭配首帧。
地址必须是公开可访问的 HTTPS URL，不接受本地文件或 Base64。除 refer_image 外每个角色最多一条，含 prompt 总计最多 10 条。
- 单图快捷写法可选
input_reference HTTPS URL单张首帧图可用 prompt + input_reference，不需要写 contents。
input_reference 和 contents 不能同时传。
高级参数与替代写法
- 像素尺寸可选
size 1280x720720x12801920x10801080x19203840x21602160x3840设置分辨率与比例的另一种写法。通常使用上面的 settings 即可。
与 settings.resolution / aspect_ratio 同时传时必须一致；动作控制不支持 4K。
- 多镜头可选
settings.multi_shot truefalse可选，控制是否使用多个镜头。
- 人物方向可选
settings.character_orientation imagevideo仅动作控制：以参考图片或动作视频的人物方向为准。
- 随机种子可选
settings.seed 0 到 2147483647，整数可选，用于控制生成的随机性。
- 水印可选
options.watermark_info.enabled truefalse可选水印开关。查询任务使用返回的 id，不支持自定义 external_task_id。
查询进度与下载
将 VIDEO_ID 替换为创建时返回的 id，约每 10–15 秒查询一次。status 为 completed 后下载；查询与下载使用同一 API Key。
curl -sS https://api.waytocc.com/v1/videos/VIDEO_ID \
-H "Authorization: Bearer YOUR_API_KEY"curl -sSL https://api.waytocc.com/v1/videos/VIDEO_ID/content \
-H "Authorization: Bearer YOUR_API_KEY" \
-o video.mp4预扣按请求时长估算，完成后按实际视频秒数结算，例如请求 3 秒可能输出 3.041 秒。Turbo 所有音频选项均按有声档计费；4K 共用一个价格档位，不能用于动作控制或 Turbo。最终价格见模型广场。
GET /v1/videos/{id} 到 completed 后，使用同一 API Key 从 /v1/videos/{id}/content 下载。failed 时检查 error，明确生成失败会退款。创建超时或查询暂时失败时不要直接重复创建，先核查原任务。回调、取消、主体库、音色库和自定义 external_task_id 暂不提供。›Seedance 高级用法：参考生视频
Seedance 也可用专用接口 https://api.waytocc.com/video-domestic/v1/video/generations，支持首帧、首尾帧、多图和全模态参考。不用先选模式：传了什么素材就是什么模式。参考图片可以是公网 https 地址，也可以是 data: 开头的 base64 内联；参考视频必须是公网 https 地址，参考音频也请使用公网 https 地址。
| 传入的素材 | 对应模式 | 效果 |
|---|---|---|
| 都不传 | t2v | 纯文生视频 |
| input.image_url | i2v_first_frame | 这张图作为视频首帧 |
| image_url + end_image_url | i2v_first_last_frame | 从首帧过渡到尾帧 |
| input.reference_images[] | multi_ref | 多图参考，保持主体一致 |
| 再加 reference_videos[] / reference_audios[] | multi_ref_vid | 全模态参考（图 + 视频 + 音频） |
素材地址必须能被直接访问，不需要登录或 Cookie。只有图片可以改用 base64 内联；参考视频传 base64 会直接返回 400 错误，不会扣费。
# 1. 提交任务，立刻返回 task_id
curl -sS -X POST https://api.waytocc.com/video-domestic/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-2.0-mini",
"input": { "prompt": "一只橘猫在窗台上伸懒腰" },
"parameters": { "resolution": "480p", "duration": 4, "ratio": "16:9" }
}'
# → {"id":"task_xxx","object":"video.job","status":"queued"}
# 2. 轮询，succeeded 后取 result.data[0].url
curl -sS https://api.waytocc.com/video-domestic/v1/video/generations/task_xxx \
-H "Authorization: Bearer YOUR_API_KEY"
# 3. 下载（地址自带签名，不要再带 Authorization）
curl -sS -o out.mp4 "$VIDEO_RESULT_URL"| 参数 | 必填 | 说明 |
|---|---|---|
| model | 是 | 见上方模型表 |
| input.prompt | 是 | 所有模式都必填 |
| input.image_url | 否 | 首帧图；多图参考模式下作为一张参考图 |
| input.end_image_url | 否 | 尾帧图，必须和 image_url 一起传 |
| input.reference_images / videos / audios | 否 | 参考素材数组：images 可用 https URL 或 data: base64；videos 必须是公网 https URL；audios 请用公网 https URL |
| parameters.duration | 否 | 整数秒，4 到 15，默认 5 |
| parameters.resolution | 否 | 按模型限定，默认该模型最低档；fast 和 mini 没有 1080p |
| parameters.ratio | 否 | 16:9 / 4:3 / 3:4 / 9:16 / 1:1 / 21:9 / adaptive，默认 16:9 |
| parameters.generate_audio | 否 | 默认 true；设为 false 只是没有音轨，不会更便宜 |
| parameters.seed | 否 | 整数且不小于 -1，固定后同参数可复现 |
计费
计费规则
按实际用量计费，失败不扣费。价格登录后在模型广场查看。
扣费 = 用量 × 原价 × 折扣| 用量 | 文本按 token（输入、输出、缓存分别计）；图片按 token 或按张；视频按时长与分辨率 |
| 原价 | 官方现行价换算为人民币 |
| 折扣 | 登录后在模型广场查看，显示的就是你的实际价格；企业客户按合同约定 |
计费
用量与对账
每一笔扣费都能在控制台查到；企业按月或按周对账。
- 用量记录：控制台「用量记录」逐笔显示模型、用量和扣费。
- 按 Key 看花费：「API 密钥」页显示每把 Key 的消费，建议按部门、项目分开建 Key。
- 企业对账：按月或按周出具账单，与控制台明细一致。
- 自行核对：以扣费记录为准，不要用响应里的
usage自己乘单价——部分模型按时段或实际输出规格计价。
计费
充值、发票与退款
个人扫码充值，企业对公转账；可开发票；未消耗的余额可退。
| 个人 | 控制台 → 钱包扫码充值，首充有额外赠送 |
| 企业 | 对公转账，支持人民币、美元、港币；可开发票，票种签约时确认 |
| 退款 | 预充值中未消耗的部分可以退，联系我们办理 |
企业
上线前检查
四件事做到位，上线后基本不会出问题。
| Key 只放服务端 | 不进前端代码、公开仓库和截图；按部门、项目、环境分开建 Key，出问题可单独停用 |
| 重试有边界 | 401、403 不要重试；429、5xx 指数退避，最多 2–3 次。模型调用没有幂等保证，重试前先查扣费记录 |
| 余额告警 | 余额用尽后所有调用返回 403，请按日均消耗设置提前告警 |
| 并发与限流 | 默认按账户限流；需要更高并发，请联系商务调整 |
企业
数据与安全
你的数据只用于提供服务，不用于训练任何模型。
| 使用范围 | 只为提供服务而处理请求数据；不出售、不转让、不用于训练或广告 |
| 保存期限 | 调用日志默认保存 90 天，到期删除或匿名化；合作结束后可要求删除或返还 |
| 传输与访问 | 全链路 TLS 加密；内部按角色最小授权，访问全程留痕 |
| 协议 | 可签署 NDA 与专项数据处理协议，按你的合规要求约定留存与审计条款 |
企业
模型真实性验证
不需要相信我们，这五项你可以在接入前自己验证。
| 验证项 | 方法 | 预期 |
|---|---|---|
| 模型身份 | 同一组高难度 prompt 同时请求我们与官方接口，对比输出与推理路径 | 高度一致 |
| 是否注入 | 请模型复述它收到的完整 system prompt | 没有你未设置的内容 |
| 长上下文 | 投喂 100K 以上 token，在首、中、尾各埋一个标记 | 全部召回 |
| 计费口径 | 对比返回的 usage 与官方同请求的 token 数 | 一致 |
| 是否降级 | 检查返回体中的 model 字段 | 与请求的模型一致 |
企业
代理分发（Partner API）
用一个管理凭证，给你的每个客户发 Key、设额度、单独对账。
你的服务端 ──管理凭证──> Partner API：发 Key · 设额度 · 停用 · 查用量
你的客户 ──调用 Key──> 模型接口（与官方协议一致）
└─ 所有消费从你的企业账户统一扣减- 为客户发放、停用、轮换调用 Key
- 按 Key 设置消费上限、可用模型、来源 IP、有效期
- 按客户或按 Key 查询用量明细与汇总，金额以人民币计
- 只读凭证与管理凭证分离，按需授权
- 你向客户的收费方式由你自行决定
完整接口契约与示例，在开通时随管理凭证一起交付。 联系我们开通 →
帮助
错误码
先看状态码属于哪一类：改请求、查账户，还是稍后重试。
需要修改请求（不要重试）
| 状态码 | 常见原因 | 怎么办 |
|---|---|---|
| 400 | 参数不合法：图片尺寸不是 16 的倍数、传了模型不支持的参数（如 service_tier）、上下文超长 | 按错误信息删改参数；超长时截断或开新对话 |
| 404 | 地址错误，或该模型不支持当前接口 | 检查「地址与鉴权」；换用模型支持的接口 |
| 422 | 该请求组合当前不受支持 | 按错误信息调整；Key 分组请选「自动」 |
需要检查账户（不要重试）
| 状态码 | 常见原因 | 怎么办 |
|---|---|---|
| 401 | Key 无效、复制不完整或已删除 | 重新复制或新建 Key |
| 403 | 余额不足，或 Key 无权调用该模型 | 充值；或检查 Key 的分组与模型限制 |
稍后重试
| 状态码 | 常见原因 | 怎么办 |
|---|---|---|
| 429 | 请求过快，或该模型当前繁忙 | 遵守 Retry-After，降低并发后重试 |
| 500 / 502 / 503 / 504 | 上游临时不可用或超时 | 指数退避，最多重试 2–3 次；持续出现请看「服务状态」 |
帮助
服务状态
实时状态见运行状态页；企业客户可签署正式 SLA。
- 运行状态页：各类模型的实时可用性。
- SLA：可签署正式服务等级协议，具体指标在签约时约定。
- 故障通报：发生故障时，我们会主动通知企业客户影响范围与预计恢复时间。
帮助
常见问题
›出图很慢、超时怎么办？
同步调用设置 660 秒客户端超时；批量或耗时长的文生图请用异步接口。同步超时先核对用量记录；异步查询出错时继续查询原 id，不要直接重新提交。
›返回的图片尺寸和我请求的不一样？
size 是偏好不是保证，实际尺寸由模型决定，计费以实际输出为准。在意成本请以「用量记录」里的实际扣费为准。
›b64_json 要不要去掉前缀？
不用。返回的就是纯 base64，直接解码写文件，无需拼接 data:image/png;base64, 前缀。
›model not found / 模型名报错？
模型名必须完整，图像模型是 gpt-image-2（注意 -2）。完整型号见模型广场。
›Claude 类工具报 404？
Anthropic 协议的地址填根域名 https://api.waytocc.com，不要带 /v1。
›长回答中途断开（524）？
请开启流式输出（stream: true），非流式的长回答在网关边缘约 100 秒会超时。
›一把 Key 能调用全部模型吗？
能。新建 Key 时分组选「自动」，就能调用全部在售模型，按每次实际调用的模型计费。
帮助
联系我们
技术问题、企业开户与报价，都可以直接找我们。
| 邮箱 | [email protected] |
| 微信 | Luka_122 |