示例与最佳实践

先试用：操练场

控制台提供登录即可试用的操练场，无需写代码即可体验：

• 对话：/console/playground/chat
• 图片：/console/playground/images
• 视频：/console/playground/videos

curl 示例

对话（OpenAI-compatible）：

curl https://api.clawto.link/v1/chat/completions   -H "Authorization: Bearer <你的 API Key>"   -H "Content-Type: application/json"   -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "你好"}]
  }'

图片与视频的完整示例见「图片生成 API」与「视频生成 API」。

最佳实践

• 保存任务 ID：视频任务完成后上游不提供任务列表，务必在业务里保存返回的任务 ID。
• 及时下载结果：视频结果保留 24 小时，完成后尽快保存到自己的存储。
• 不混用 Key：文本 / 生图 / 视频 Key 分开管理。
• 重试与限速：遇到 429 按 Retry-After 稍后重试；开启 API Key 限流时注意控制频率。
• 保护 Key：不要把 Key 提交到 Git 仓库或公开截图。