安装与环境变量

macOS、Linux 和大多数 CI runner 默认包含 cURL。Windows 可使用 PowerShell、Git Bash 或 WSL。

export UOUODUO_API_KEY="sk-xxx..."
export UOUODUO_BASE_URL="https://api.example.com/v1"

Chat Completions

curl "$UOUODUO_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $UOUODUO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "user", "content": "Return ok and one short sentence." }
    ]
  }'

Streaming

curl -N "$UOUODUO_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $UOUODUO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "stream": true,
    "messages": [
      { "role": "user", "content": "逐字输出一句中文问候。" }
    ]
  }'

`-N` 会关闭 curl 的输出缓冲，便于直接观察 SSE chunk。

Embeddings

curl "$UOUODUO_BASE_URL/embeddings" \
  -H "Authorization: Bearer $UOUODUO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": ["第一段文本", "第二段文本"]
  }'

Models

curl "$UOUODUO_BASE_URL/models" \
  -H "Authorization: Bearer $UOUODUO_API_KEY"

Audio transcription

curl "$UOUODUO_BASE_URL/audio/transcriptions" \
  -H "Authorization: Bearer $UOUODUO_API_KEY" \
  -F file="@meeting.mp3" \
  -F model="whisper-1"

排查建议

• 401：确认环境变量不是空值，且 key 来自 `/app/keys`。
• 404：确认 base URL 包含 `/v1`。
• 429：查看响应 header 和 `/app/usage`，按 key 拆分流量。
• 5xx：记录 request id、时间、模型和 payload 摘要，再查看 `/status`。