API 接入文档

OpenAI 兼容格式。这里是快速上手,登录后在控制台「API 密钥」页可以看到每个模型的完整参数说明,并下载 Markdown 版文档。

1. 准备

  1. 注册账号,在控制台「充值」页充值。
  2. 在控制台「API 密钥」页复制密钥(以 sk- 开头)。密钥只放在服务端,不要写进网页或 App 前端。
  3. 接口地址:https://gw.czgen.org/v1

如果你的网络连不上上面的地址(连接超时),换成备用地址 https://czgen.org/v1,密钥不变。备用地址走 Cloudflare,单个请求超过约 100 秒会被断开——图片、视频提交都可能中招,所以耗时长的请求请用默认地址。

2. 生成图片

export API_KEY="sk-你的密钥"

curl -s --max-time 300 https://gw.czgen.org/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2.5-sunburst","prompt":"桌上一只红苹果,产品摄影","size":"1024x1024","n":1}' \
  | jq -r '.data[0].b64_json' | base64 -d > out.png

可用的图片模型和价格见价格页。图片生成请把超时设到 300 秒以上:2K 一般 1–2 分钟,4K 可能要 3–6 分钟(实测最长 6 分钟)。

用 OpenAI SDK(Python)

import base64
from openai import OpenAI

client = OpenAI(base_url="https://gw.czgen.org/v1", api_key="sk-你的密钥", timeout=300)
img = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt="白色背景上的一双运动鞋,电商主图",
    size="1024x1024",
)
open("out.png", "wb").write(base64.b64decode(img.data[0].b64_json))

3. 生成视频

视频是异步任务:先提交拿到任务 ID,再轮询进度,完成后下载。

# 提交(文生视频)
curl -s https://gw.czgen.org/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 你自己生成的唯一字符串" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "海边日落,镜头缓慢摇移",
    "seconds": "6",
    "size": "1280x720",
    "resolution_name": "720p"
  }'

# 返回里的 id 就是任务 ID;每 5 秒查询一次进度
curl -s https://gw.czgen.org/v1/videos/$TASK_ID -H "Authorization: Bearer $API_KEY"

# status 为 completed 后下载成品
curl -s -L -o out.mp4 https://gw.czgen.org/v1/videos/$TASK_ID/content -H "Authorization: Bearer $API_KEY"

4. 文字对话

curl https://gw.czgen.org/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.8-flash","messages":[{"role":"user","content":"帮我写一句护肤精华的卖点文案"}]}'

5. 常见错误

每一次调用的耗时、扣费和请求 ID 都能在控制台「使用日志」里查到,反馈问题时附上请求 ID 能更快定位。客服微信/QQ:9684546(不要发送完整 API 密钥)。