API 手册
通过统一鉴权调用 wylon 的文本生成、文生图和文生视频能力。本手册按能力与调用工作流组织，帮助你快速找到正确的端点和参数。
接入基础
Base URL所有 V1 端点
https://api.wylon.cn/v1AuthorizationHTTP Bearer必填
Bearer 令牌。可前往 控制台 创建 API 密钥，并将其保存为环境变量
$WYLON_API_KEY。不要将密钥写入前端代码或公开仓库。协议兼容按端点区分
文本生成支持 OpenAI Chat Completions 与 Anthropic Messages；同步文生图兼容 OpenAI Images；异步图片和视频生成使用 wylon 内容任务接口。
按能力选择 API
目录按用户目标组织。相同任务路径通过请求中的 type 区分图片和视频，不代表两种能力共享全部参数。
文本生成
文生图
文生视频
通用接口
完成第一次只读调用
先调用模型列表检查服务地址、鉴权和目标模型 ID，再进入对应生成端点。
cURL
curl https://api.wylon.cn/v1/models \
-H "Authorization: Bearer $WYLON_API_KEY"同步与异步调用
同步文生图
客户端保持连接，图片生成完成后在同一次响应中取得结果。适合用户正在等待的交互式场景。
异步内容任务
创建任务后保存 id，随后查询状态。适合图片后台处理和耗时更长的视频生成。
- 创建任务
- 保存任务 ID
- 查询状态
- 读取结果
- 下载或转存
创建任务返回 HTTP 200 只表示任务已受理。生成是否成功，以查询响应中的 status 为准。结果 URL 为短时效地址，应及时下载或转存。
错误处理与重试
| 状态码 | 常见原因 | 建议操作 |
|---|---|---|
400 | 请求字段、类型或模型参数不合法 | 根据端点页和当前模型限制修正请求 |
401 | API 密钥缺失、无效或已撤销 | 检查鉴权请求头和密钥状态 |
403 | 当前身份无模型或任务访问权限 | 检查账户、API 密钥和模型权限 |
429 | 触发频率、并发或容量限制 | 降低请求频率并逐步增加重试间隔 |
500、503 | 服务内部异常或模型暂时不可用 | 已有任务 ID 时优先查询原任务 |
504 | 同步生成未在等待期限内返回结果 | 确认原请求状态后再决定是否创建新请求 |
重复发送生成类 POST 请求会创建独立请求或任务，并可能产生新的实际用量。
