Chat & Image Generation API 对话与图像生成 API

What's available服务内容

You can use these two ways: through our hosted web chat (no code, images appear inline in the conversation), or by calling the APIs directly from your own code. 您可以通过两种方式使用：通过我们托管的网页聊天界面（无需编写代码，图像会直接显示在对话中）， 或直接在您自己的代码中调用 API。

Option 1 — Hosted Web Chat 方式一 — 托管网页聊天 live已上线

The easiest way to try both models together — ask for an image in a normal chat and it generates and shows up inline. 最简单的体验方式 — 在正常对话中直接要求生成图像，图像会自动生成并显示在对话中。

Option 2 — Direct API Access方式二 — 直接调用 API

Both endpoints speak the OpenAI API shape your existing client code already knows — integration is normally a base URL + auth header change. 两个接口均采用与 OpenAI API 相同的调用格式，与您现有的客户端代码兼容 — 通常只需更改 base URL 和认证请求头即可完成对接。

Authentication身份认证

Every API request needs two headers, from a Cloudflare Access Service Token issued to your team — request it from your contact rather than reusing another team's token. 每次 API 请求都需要携带两个请求头，其值来自 Cloudflare Access 为您的团队签发的 Service Token — 请向您的对接人申请专属令牌，不要复用其他团队的令牌。

CF-Access-Client-Id: <your-client-id>
CF-Access-Client-Secret: <your-client-secret>

Keep the secret out of shell history and process args — don't pass it as a curl -H command-line argument on a shared machine. Use a curl --config file created with umask 077, or your app's environment/secrets manager. 请勿将密钥暴露在 shell 历史记录或进程参数中 — 在共享机器上不要以 curl -H 命令行参数的形式传递密钥。建议使用 umask 077 创建的 curl --config 配置文件， 或使用您应用的环境变量 / 密钥管理服务。

Chat Completions (Nemotron)对话补全接口（Nemotron） live已上线

Your team's Service Token is provisioned — this endpoint is ready to use. 您团队专属的 Service Token 已开通 — 该接口现已可用。

from openai import OpenAI

client = OpenAI(
    base_url="https://nemotron3-ultra.tfd-runai.com/v1",
    api_key="unused",  # auth is via the CF-Access-* headers below, not a bearer key
    default_headers={
        "CF-Access-Client-Id": "<your-client-id>",
        "CF-Access-Client-Secret": "<your-client-secret>",
    },
)

result = client.chat.completions.create(
    model="nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-NVFP4",
    messages=[{"role": "user", "content": "Describe a mid-century modern armchair in one paragraph."}],
)
print(result.choices[0].message.content)

Image Generation (Qwen-Image)图像生成接口（Qwen-Image） live已上线

Your team's Service Token is provisioned — this endpoint is ready to use. 您团队专属的 Service Token 已开通 — 该接口现已可用。

Request fields请求参数 — POST /v1/images/generations

curl -s https://qwen-image.tfd-runai.com/v1/images/generations \
  --config ~/.cf-access-furniture-comp.curl \
  -H 'Content-Type: application/json' \
  -d '{
        "prompt": "A minimalist wooden dining chair, natural oak finish, plain white studio background",
        "size": "1024x1024",
        "n": 1
      }' | jq -r '.data[0].b64_json' | base64 -d > chair.png

curl -s https://qwen-image.tfd-runai.com/v1/images/generations \
  --config ~/.cf-access-furniture-comp.curl \
  -H 'Content-Type: application/json' \
  -d '{
        "prompt": "极简风格木质餐椅，天然橡木色，纯白影棚背景",
        "size": "1024x1024",
        "n": 1
      }' | jq -r '.data[0].b64_json' | base64 -d > chair.png

Known limits (test deployment)已知限制（测试阶段）

• No SLA — single-replica GPU serving for evaluation, not scaled for production traffic. 暂无 SLA 保障 — 目前为单副本 GPU 部署，用于评估测试，尚未针对生产流量扩容。
• response_format: "url" is not implemented on the image endpoint — always use b64_json or file. 图像接口未实现 response_format: "url" — 请始终使用 b64_json 或 file。
• Requests without the two CF-Access-* headers get intercepted by Cloudflare Access (a redirect/403), not a model-side error. 缺少两个 CF-Access-* 请求头的请求会被 Cloudflare Access 拦截（返回重定向或 403），而非模型端报错。
• Image editing / multi-image composition is not deployed — ask us if your workflow needs it. 图像编辑 / 多图合成功能尚未部署 — 如您的业务流程需要，请联系我们开通。