API 參考

完整的 API 介面文件

基礎 URL

https://api.thistoken.ai

認證

所有 API 請求都需要在 Header 中攜帶 API Key：

Authorization: Bearer YOUR_API_KEY

介面列表

POST/v1/chat/completions

建立聊天補全

參數

參數名	類型	必填	說明
model	string	是	模型名稱，如 gpt-4o, claude-3.5-sonnet
messages	array	是	訊息陣列，包含 role 和 content
temperature	number	否	取樣溫度，0-2，預設 1
max_tokens	integer	否	最大生成 token 數
stream	boolean	否	是否串流輸出，預設 false

範例請求

curl https://api.thistoken.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

POST/v1/embeddings

建立文字嵌入向量

參數

參數名	類型	必填	說明
model	string	是	嵌入模型名稱，如 text-embedding-3-small
input	string\|array	是	要嵌入的文字

範例請求

curl https://api.thistoken.ai/v1/embeddings \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "Hello world"
  }'

GET/v1/models

取得可用模型列表

範例請求

curl https://api.thistoken.ai/v1/models \
  -H "Authorization: Bearer $API_KEY"

POST/v1/images/generations

生成圖像

參數

參數名	類型	必填	說明
model	string	是	圖像模型，如 dall-e-3
prompt	string	是	圖像描述
size	string	否	圖像尺寸，如 1024x1024

範例請求

curl https://api.thistoken.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A cute cat",
    "size": "1024x1024"
  }'

錯誤碼

錯誤碼	說明
400	請求參數錯誤
401	認證失敗，API Key 無效
402	餘額不足
429	請求過於頻繁，觸發限流
500	伺服器內部錯誤