文档开始使用快速开始
快速开始
创建 API Key，几分钟内用任一方言完成首次调用。
本页带你完成最小可用集成：创建 Key → 发出第一条请求 → 查看用量。
第 1 步：创建 API Key
注册并登录控制台，在「API Key」页新建一把密钥。Key 形如 sk-sole-…。
完整 Key 只在创建时展示一次，服务端仅保存哈希。请立即保存到密钥管理器或环境变量，丢失后只能重建。
第 2 步：首次调用（OpenAI 兼容）
推荐从 Responses API 开始——这也是 Codex 等编码工具实际使用的入口：
curl https://api.soleapi.com/v1/responses \
-H "Authorization: Bearer $SOLEAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-fable-5",
"input": "Say hello in one sentence"
}'from openai import OpenAI
client = OpenAI(
api_key="sk-sole-...",
base_url="https://api.soleapi.com/v1",
)
resp = client.responses.create(
model="claude-fable-5",
input="Say hello in one sentence",
)
print(resp.output_text)import OpenAI from 'openai'
const client = new OpenAI({
apiKey: 'sk-sole-...',
baseURL: 'https://api.soleapi.com/v1',
})
const resp = await client.responses.create({
model: 'claude-fable-5',
input: 'Say hello in one sentence',
})
console.log(resp.output_text)Anthropic 格式（Messages API）
使用 Anthropic SDK 或 Claude Code 时，走 /v1/messages，鉴权头换成 x-api-key：
curl https://api.soleapi.com/v1/messages \
-H "x-api-key: $SOLEAPI_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-fable-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Say hello in one sentence"}]
}'import anthropic
client = anthropic.Anthropic(
api_key="sk-sole-...",
base_url="https://api.soleapi.com",
)
msg = client.messages.create(
model="claude-fable-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Say hello in one sentence"}],
)
print(msg.content[0].text)Gemini 格式
使用 Google GenAI SDK 时，走 /v1beta 入口，鉴权头是 x-goog-api-key：
curl "https://api.soleapi.com/v1beta/models/gemini-2.5-pro:generateContent" \
-H "x-goog-api-key: $SOLEAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"parts": [{"text": "Say hello in one sentence"}]}]
}'from google import genai
client = genai.Client(
api_key="sk-sole-...",
http_options={"base_url": "https://api.soleapi.com"},
)
resp = client.models.generate_content(
model="gemini-2.5-pro",
contents="Say hello in one sentence",
)
print(resp.text)Gemini 方言不支持用 ?key= 查询参数传 Key，必须放在 x-goog-api-key 头里，详见鉴权。
第 3 步：查看用量与账单
进入控制台可以看到实时余额、用量趋势、按 Key 的统计与逐请求明细。计费规则见计费与余额。