第一次调用

复制即用的示例，先跑通最小请求，再加高级参数。

把 sk-你的Token 换成你在控制台创建的 API Key。

OpenAI 兼容接口

最通用的方式，所有厂商的模型都支持。

curl

curl https://api.smartwan.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的Token" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "user", "content": "你好，请用一句话确认你已接入成功。"}
    ],
    "max_tokens": 100
  }'

Python

pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的Token",
    base_url="https://api.smartwan.com/v1",
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好，请回复一句：调用成功"}],
    max_tokens=100,
)

print(response.choices[0].message.content)

Node.js

npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的Token",
  baseURL: "https://api.smartwan.com/v1",
});

const response = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "你好，请回复一句：调用成功" }],
  max_tokens: 100,
});

console.log(response.choices[0].message.content);

成功时 choices[0].message.content 里是模型回复。

Anthropic Messages 接口

用 Claude 系列或需要 Anthropic 格式时用这个。注意 Header 是 x-api-key。

curl https://api.smartwan.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-你的Token" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-haiku-4-5",
    "max_tokens": 100,
    "messages": [
      {"role": "user", "content": "你好，请回复一句：调用成功"}
    ]
  }'

回复在 content 数组的 text 字段里。

Gemini 原生接口

模型名写在 URL 路径里，Header 用 x-goog-api-key。

curl https://api.smartwan.com/v1beta/models/gemini-2.5-pro:generateContent \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: sk-你的Token" \
  -d '{
    "contents": [{"parts": [{"text": "你好，请回复一句：调用成功"}]}],
    "generationConfig": {"maxOutputTokens": 100, "temperature": 0.7}
  }'

也可以把 Key 放查询参数：?key=sk-你的Token。

Responses API

curl https://api.smartwan.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的Token" \
  -d '{
    "model": "gpt-5.5",
    "input": "用一句话介绍你自己",
    "max_output_tokens": 100
  }'

仅部分模型支持

Responses API 目前只在 GPT 系模型上验证可用。DeepSeek、Kimi、Claude 等会返回 not implemented——改用 /v1/chat/completions 即可。

图片生成

curl https://api.smartwan.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的Token" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只坐在书桌旁阅读文档的橘猫，简洁插画风格",
    "n": 1,
    "size": "1024x1024"
  }'

图片编辑用 /v1/images/edits，需上传有效图片文件。

怎么算成功

项目	预期
HTTP 状态码	200
OpenAI 兼容响应	choices[0].message.content 有文本
Anthropic 响应	content 数组里有 text
usage	部分接口返回 token 用量，可用于核对消耗

跑不通先查这四项

检查项	说明
Key	是否完整复制、是否过期、账户是否有额度
Base URL	SDK 填到 /v1 为止，curl 写完整路径
模型名	从模型列表复制，大小写敏感
Header	与协议匹配——OpenAI 用 Authorization，Anthropic 用 x-api-key，Gemini 用 x-goog-api-key

先用最小参数跑通，再逐步加 temperature、tools 这些。仍失败见常见问题。

下一步

• 厂商调用差异 — 各家的特殊参数限制
• 认证与 Base URL — 地址和鉴权的完整说明