二豆 API 接入文档

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

curl https://api.erdou.xyz/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "YOUR_MODEL_ID",
      "object": "model",
      "owned_by": "system"
    }
  ]
}

curl https://api.erdou.xyz/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [
      {"role": "user", "content": "你好，请只回复：连接成功"}
    ]
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ERDOU_API_KEY"],
    base_url="https://api.erdou.xyz/v1",
)

response = client.chat.completions.create(
    model="YOUR_CHAT_MODEL",
    messages=[{"role": "user", "content": "你好，请只回复：连接成功"}],
)

print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.ERDOU_API_KEY,
  baseURL: "https://api.erdou.xyz/v1",
});

const response = await client.chat.completions.create({
  model: "YOUR_CHAT_MODEL",
  messages: [{ role: "user", content: "你好，请只回复：连接成功" }],
});

console.log(response.choices[0].message.content);

{
  "model": "YOUR_CHAT_MODEL",
  "messages": [
    {"role": "system", "content": "你是一个简洁的中文助手。"},
    {"role": "user", "content": "用三点说明 HTTPS 的作用。"}
  ],
  "stream": false
}

curl https://api.erdou.xyz/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RESPONSES_MODEL",
    "input": "解释幂等请求的作用"
  }'

curl -N https://api.erdou.xyz/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [{"role": "user", "content": "写一句欢迎语"}],
    "stream": true
  }'

curl https://api.erdou.xyz/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: image-demo-001" \
  -d '{
    "model": "YOUR_IMAGE_MODEL",
    "prompt": "一只白色陶瓷杯，干净的摄影棚背景，柔和自然光",
    "n": 1,
    "resolution": "1K",
    "aspect_ratio": "1:1"
  }'

{
  "id": "task_PUBLIC_TASK_ID",
  "object": "image_generation.task",
  "created_at": 1760000000,
  "status": "pending",
  "model": "YOUR_IMAGE_MODEL",
  "progress": "10%",
  "data": []
}

curl https://api.erdou.xyz/v1/images/tasks/task_PUBLIC_TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "task_PUBLIC_TASK_ID",
  "object": "image_generation.task",
  "created_at": 1760000000,
  "completed_at": 1760000042,
  "status": "completed",
  "model": "YOUR_IMAGE_MODEL",
  "progress": "100%",
  "data": [
    {
      "index": 0,
      "url": "https://api.erdou.xyz/v1/images/tasks/task_PUBLIC_TASK_ID/results/0",
      "mime_type": "image/png",
      "width": 1024,
      "height": 1024
    }
  ]
}

const baseURL = "https://api.erdou.xyz/v1";
const headers = { Authorization: `Bearer ${process.env.ERDOU_API_KEY}` };

async function waitForImage(taskId) {
  for (let attempt = 0; attempt < 120; attempt += 1) {
    const response = await fetch(`${baseURL}/images/tasks/${taskId}`, { headers });
    if (!response.ok) throw new Error(`Task query failed: ${response.status}`);

    const task = await response.json();
    if (task.status === "completed") return task;
    if (task.status === "failed") {
      throw new Error(task.error?.message || "Image generation failed");
    }

    await new Promise((resolve) => setTimeout(resolve, 5000));
  }

  throw new Error("Task polling timed out; keep the task ID and query later");
}

curl "https://api.erdou.xyz/v1/images/tasks/task_PUBLIC_TASK_ID/results/0" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output result.png

{
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "保持主体构图，将背景改成雨后的城市街道",
  "reference_images": [
    "https://your-public-domain.example/reference.png"
  ],
  "n": 1,
  "resolution": "1K",
  "aspect_ratio": "16:9"
}

Idempotency-Key: order-20260728-000001-image-1

{
  "error": {
    "message": "model is required",
    "code": "invalid_request"
  }
}