思畅 AI
创建 API Key

开始

5 分钟快速开始

1. 创建 API Key

在设置 → API 创建 Key，按需要勾选权限（对话与编程 Agent / 图片生成与编辑 / 视频生成）。Key 只在创建时显示一次，存进环境变量：

export SICHANG_API_KEY=sc_...

2. 自检

curl -s https://sichang.xyz/api/v1/me \
  -H "Authorization: Bearer $SICHANG_API_KEY"

返回余额、这把 Key 的权限与限额。

3. 第一个对话请求

对话模型 id 见对话模型。下面三种写法等价。

curl https://sichang.xyz/api/v1/chat/completions \
  -H "Authorization: Bearer $SICHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "<模型 id>", "messages": [{"role": "user", "content": "你好"}]}'
from openai import OpenAI
import os

client = OpenAI(base_url="https://sichang.xyz/api/v1", api_key=os.environ["SICHANG_API_KEY"])
resp = client.chat.completions.create(
    model="<模型 id>",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
import OpenAI from 'openai'

const client = new OpenAI({ baseURL: 'https://sichang.xyz/api/v1', apiKey: process.env.SICHANG_API_KEY })
const resp = await client.chat.completions.create({
  model: '<模型 id>',
  messages: [{ role: 'user', content: '你好' }],
})
console.log(resp.choices[0].message.content)

4. 生成第一张图

图片是异步任务：提交返回 202 与任务 id，再长轮询到完成。模型 id 见图片模型。

curl -s -X POST https://sichang.xyz/api/v1/images \
  -H "Authorization: Bearer $SICHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"prompt":"a corgi surfing at sunset","model":"z-image-turbo","aspectRatio":"16:9","resolution":"1K"}'
# status 不是 COMPLETED / FAILED / EXPIRED 就再调一次;downloadUrl 15 分钟内有效
curl -s "https://sichang.xyz/api/v1/jobs/$JOB_ID?wait=30" \
  -H "Authorization: Bearer $SICHANG_API_KEY"

Idempotency-Key 让网络重试不会重复扣费：同一个 key 重发只会拿回第一次的结果。

下一步