Introduction

# Any OpenAI-compatible client works — just swap the base URL
curl https://api.canalapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CANAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "messages": [{"role":"user","content":"Hello"}]
  }'

{
  "id": "chatcmpl_8K2m3",
  "object": "chat.completion",
  "created": 1745078400,
  "model": "claude-opus-4-6",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "Hi there!" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 8, "completion_tokens": 3, "total_tokens": 11 }
}

stream = client.chat.completions.create(
  model="claude-opus-4-6",
  messages=[{"role": "user", "content": "Write a haiku."}],
  stream=True,
)
for chunk in stream:
  print(chunk.choices[0].delta.content or "", end="")

# 把 Gemini SDK 的 base_url 指向 CanalAPI 的 /v1beta，用 CanalAPI 密钥鉴权
curl "https://api.canalapi.com/v1beta/models/gemini-3.1-pro-preview:generateContent" \
  -H "x-goog-api-key: $CANAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "parts": [{ "text": "Hello" }] }]
  }'

# 流式：streamGenerateContent + ?alt=sse；鉴权头同样可用 Authorization: Bearer
curl "https://api.canalapi.com/v1beta/models/gemini-3.1-pro-preview:streamGenerateContent?alt=sse" \
  -H "Authorization: Bearer $CANAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "parts": [{ "text": "Write a haiku." }] }]
  }'

import { GoogleGenerativeAI } from "@google/generative-ai";

// 把 SDK 的 baseUrl 指向 CanalAPI 的 /v1beta，apiKey 用 CanalAPI 密钥
const genAI = new GoogleGenerativeAI(process.env.CANAL_KEY, {
  baseUrl: "https://api.canalapi.com/v1beta",
});

const model = genAI.getGenerativeModel({ model: "gemini-3.1-pro-preview" });
const result = await model.generateContent("Hello");
console.log(result.response.text());

# multipart/form-data：image + prompt 必填，mask 可选
curl https://api.canalapi.com/v1/images/edits \
  -H "Authorization: Bearer $CANAL_KEY" \
  -F image="@source.png" \
  -F prompt="Add a red hat to the cat" \
  -F model="gpt-image-1" \
  -F n=1 \
  -F size="1024x1024"

# multipart/form-data：仅需 image
curl https://api.canalapi.com/v1/images/variations \
  -H "Authorization: Bearer $CANAL_KEY" \
  -F image="@source.png" \
  -F n=2 \
  -F size="1024x1024"