开始你的第一次 API 调用。

1. 准备 API Key

在用户控制台创建密钥，保存到服务器的 SCENEPOND_API_KEY 环境变量中。网站登录会话不能作为 API Key 使用。

export SCENEPOND_API_KEY="YOUR_SCENEPOND_API_KEY"

2. 设置 API 地址

使用 Authorization: Bearer 携带 API Key。请使用 HTTPS，不要把密钥写进浏览器代码或 URL。

3. 发起请求

1curl "https://scenepond-api-production.up.railway.app/v1/chat/completions" \
2  -H "Authorization: Bearer $SCENEPOND_API_KEY" \
3  -H "Content-Type: application/json" \
4  --data-binary @- <<'JSON'
5{
6  "model": "deepseek-flash",
7  "messages": [
8    {
9      "role": "user",
10      "content": "Hello!"
11    }
12  ],
13  "stream": false
14}
15JSON

示例使用 chat completions 协议。图片、视频和任务 API 可能使用不同请求格式，接入前请确认模型接口和已配置供应商。

异步任务

图片与视频任务会在生成完成前返回 ID。提交一次并保存 ID，轮询状态，成功后再获取生成文件。

在模型页面查看准确的必填字段、可选生成设置，以及 Video 或 Responses 兼容协议。视频 Responses 必须设置 background:true；文本模型的 Responses 使用不同规则。

使用同一账户的 API Key 获取任务结果。等待 SUCCESS 或 completed 后再下载；出现 FAILURE 或 failed 时检查错误。请求超时后，不要盲目重复付费 POST 请求。

4. 查看余额与用量

请求由现有后端结算。调用前比较模型价格，调用后在用量记录中查看实际费用。

处理 API 错误

模型 API 文档

选择模型，查看其 API 协议和请求示例。