如愿AI API 文档

快速开始

所有接口的 base URL：

访问 控制台 创建一个 API Key（令牌），然后在请求头加 Authorization: Bearer YOUR_KEY 即可。最小可用示例（聊天）：

curl https://www.dayueai.fun/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role":"user","content":"你好"}]
  }'

认证

所有 API 通过 HTTP Header Authorization: Bearer YOUR_KEY 鉴权。在控制台 → 令牌 中创建。

支持模型

DayueAI 聚合了主流国内外模型，下面列出常用清单（实时价格请查询 /api/pricing）：

价格 / 计费

实时计算公式：最终价 = model_price × group_ratio[group]。查询接口：

返回 data[] 含每个模型的 model_name / model_price / enable_groups，group_ratio 给出每个分组的折扣（默认分组 ratio=1）。代理价分组最低 4 折。

聊天 · Chat Completions /v1

请求体

示例（Python OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxx",
    base_url="https://www.dayueai.fun/v1"
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role":"system","content":"你是一名资深 AI 工程师"},
        {"role":"user","content":"用一句话解释 RAG"}
    ],
    stream=False
)
print(resp.choices[0].message.content)

图片 · Image Generation /v1

请求体

curl https://www.dayueai.fun/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "未来感都市夜景，赛博朋克风格，4K",
    "size": "1024x1024",
    "n": 1
  }'

返回示例：{ "data": [ { "url": "https://..." } ] }

视频 · Video Generation /v1

视频是异步任务：先 POST 创建任务，拿到 video_id 后用通用进度接口轮询。

创建视频任务

curl https://www.dayueai.fun/v1/videos \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo_3_1-fast",
    "prompt": "镜头从天空俯瞰一片金色麦田，慢速推进",
    "size": "16:9",
    "duration": 8
  }'

返回：{ "id": "vid_xxx", "status": "processing" }

轮询任务进度（共用接口）

Veo / Sora-2 / Grok 等所有视频任务都通过这个接口查询。

curl https://www.dayueai.fun/v1/videos/vid_xxx \
  -H "Authorization: Bearer sk-xxxxxxxx"

# 完成后返回:
# { "id": "vid_xxx", "status": "succeeded",
#   "video_url": "https://...mp4", "thumbnail_url": "..." }

音频 · Audio /v1

语音合成 TTS

curl https://www.dayueai.fun/v1/audio/speech \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tts-1",
    "input": "你好，欢迎使用 DayueAI",
    "voice": "alloy"
  }' --output speech.mp3

AI 音乐生成（Suno / Udio）

音乐任务复用视频接口，model 填 suno-v4 或 udio-130，type 填 audio。轮询同视频。

Gemini 原生格式 /v1beta

除了 OpenAI 兼容路由，DayueAI 也支持 Google Gemini 原生格式：

curl https://www.dayueai.fun/v1beta/models/gemini-2.5-pro:generateContent \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "systemInstruction": {"parts":[{"text":"你是助理"}]},
    "contents": [{"parts":[{"text":"用三句话介绍 Gemini"}]}],
    "generationConfig": {
      "responseModalities": ["TEXT"]
    }
  }'

用于图像生成时把 responseModalities 改为 ["IMAGE"]，并通过 fileData.mimeType + fileData.fileUri 传参考图。

余额 / 额度

返回当前令牌可用额度和总额。用于前端展示余额条。

错误码