快速开始

curl https://api.tokentosea.com/v1/chat/completions \
  -H "Authorization: Bearer $TOKENTOSEA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "qwen3.8-flash",
    "messages": [
      {"role": "system", "content": "你是简洁的中文助手。"},
      {"role": "user", "content": "用三句话解释什么是向量检索。"}
    ],
    "max_tokens": 512
  }'

import os
import uuid

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TOKENTOSEA_API_KEY"],
    base_url="https://api.tokentosea.com/v1",
    max_retries=0,  # 网络失败时按幂等键查询结果，不要让 SDK 自动换键重发
)

request_key = str(uuid.uuid4())
completion = client.chat.completions.create(
    model="qwen3.8-flash",
    messages=[
        {"role": "system", "content": "你是简洁的中文助手。"},
        {"role": "user", "content": "用三句话解释什么是向量检索。"},
    ],
    max_tokens=512,
    extra_headers={"Idempotency-Key": request_key},
)
print(completion.choices[0].message.content)
print("用量：", completion.usage)
print("幂等键：", request_key)

// node quickstart.mjs（Node.js 18+）
import { randomUUID } from 'node:crypto';

const requestKey = randomUUID();
const response = await fetch('https://api.tokentosea.com/v1/chat/completions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TOKENTOSEA_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': requestKey,
  },
  body: JSON.stringify({
    model: 'qwen3.8-flash',
    messages: [
      { role: 'system', content: '你是简洁的中文助手。' },
      { role: 'user', content: '用三句话解释什么是向量检索。' },
    ],
    max_tokens: 512,
  }),
});

const body = await response.json();
if (response.status === 202) {
  console.log('结果仍在处理，稍后查询：', `/v1/results/${requestKey}`, body.status);
} else if (!response.ok) {
  console.error('调用失败：', response.status, body.error?.code, body.error?.message ?? '');
} else {
  console.log(body.choices[0].message.content);
  console.log('用量：', body.usage);
}