熊猫世界熊猫世界

API 参考

熊猫世界 OpenAI 兼容网关的完整 API 参考

基础地址： https://api.pandaworld.space/v1

备用端点： https://pandaworld.space/api/v1 （两者效果相同）

聊天补全

为给定的聊天对话创建模型响应。

端点

cURL
POST /v1/chat/completions

请求体

参数类型必填描述
modelstring必填模型 ID（例如 deepseek-v4-flash），或使用智能路由："auto"、"auto:cost"、"auto:quality"、"auto:speed" — 系统会根据请求信号自动选择最佳模型
messagesarray必填消息对象数组（{role, content}）
streamboolean可选启用 SSE 流式响应（默认：false）
max_tokensinteger可选响应中的最大 token 数
temperaturenumber可选采样温度（0-2，默认：1.0）
top_pnumber可选核采样参数（0-1，默认：1.0）

请求示例

cURL
curl https://api.pandaworld.space/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PANDA_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is the capital of France?"}
    ],
    "temperature": 0.7,
    "max_tokens": 200
  }'

响应示例

JSON
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1700000000,
  "model": "deepseek-v4-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "The capital of France is Paris."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 8,
    "total_tokens": 28
  }
}

流式响应 (SSE)

设置 stream: true 以接收服务器发送事件。每个事件是一个 data: {...} 行，包含增量内容：

cURL
curl https://api.pandaworld.space/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PANDA_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Count to 5."}],
    "stream": true
  }'

流式响应格式：

cURL
data: {"id":"...","object":"chat.completion.chunk","choices":[{"delta":{"content":"1"}}]}
data: {"id":"...","object":"chat.completion.chunk","choices":[{"delta":{"content":"2"}}]}
data: [DONE]

模型列表

查看所有可用模型。

端点

cURL
GET /v1/models

请求示例

cURL
curl https://api.pandaworld.space/v1/models \
  -H "Authorization: Bearer $PANDA_API_KEY"

用户余额

查看当前账户余额。

端点

cURL
GET /v1/dashboard/billing

请求示例

cURL
curl https://api.pandaworld.space/v1/dashboard/billing \
  -H "Authorization: Bearer $PANDA_API_KEY"

响应示例

JSON
{
  "balance": 42.50,
  "currency": "usd",
  "total_spent": 157.30
}

图像生成

使用文本提示词通过专用图像生成模型创建图像。

端点

cURL
POST /v1/images/generations

请求体

参数类型必填描述
modelstring必填模型 ID（例如 wan-2.7-image、kolors）
promptstring必填期望图像的文本描述
ninteger可选生成的图像数量（1-10，默认：1）
sizestring可选图像尺寸（例如 "1024x1024"）。支持的尺寸取决于模型。

请求示例

cURL
curl https://api.pandaworld.space/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PANDA_API_KEY" \
  -d {
    "model": "wan-2.7-image",
    "prompt": "一只可爱的猫坐在窗台上，数字艺术风格",
    "n": 1,
    "size": "1024x1024"
  }

响应示例

响应在 data 数组中包含生成的图像 URL。

JSON
{
  "created": 1700000000,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "..."
    }
  ]
}

视频生成

通过文本或图像提示词生成视频。视频生成通过聊天补全端点使用专用视频模型实现。视频模型不支持流式响应——请将 stream 设为 false。

端点

cURL
POST /v1/chat/completions

请求体

参数类型必填描述
modelstring必填模型 ID（例如 wan-2.7-video）
messagesarray必填消息对象数组。用户消息中包含文本提示词。对于图生视频，可在消息内容中包含图像 URL。
streamboolean可选视频模型必须设为 false

请求示例

cURL
curl https://api.pandaworld.space/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PANDA_API_KEY" \
  -d {
    "model": "wan-2.7-video",
    "messages": [
      {"role": "user", "content": "日落时分未来城市的电影级无人机航拍镜头，霓虹灯光"}
    ],
    "stream": false
  }

注意：视频生成是异步过程。API 会在视频就绪后返回补全响应。生成时间因模型和复杂度而异（通常 30 秒到数分钟）。

OpenAI 兼容性

支持的端点（均匹配 OpenAI 接口）：

  • POST /v1/chat/completions
  • POST /v1/completions (legacy)
  • POST /v1/images/generations
  • GET /v1/models
  • GET /v1/models/:id

不支持：/v1/embeddings、/v1/audio、/v1/fine_tuning、/v1/moderations。