接入文档

# 在你自己的终端设置；不要将真实值贴给 AI 或提交到代码仓库。
export DONGAI_API_KEY='YOUR_DONGAI_API_KEY'
curl --fail-with-body 'https://api.tongyuye.com/v1/models' \
  -H "Authorization: Bearer $DONGAI_API_KEY"

curl --fail-with-body --max-time 180 'https://api.tongyuye.com/v1/chat/completions' \
  -H "Authorization: Bearer $DONGAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"model":"Deepseek-v4-flash-0731-Official-key","messages":[{"role":"user","content":"你好，请用一句话介绍你自己"}],"stream":false}'

curl --fail-with-body --max-time 180 'https://api.tongyuye.com/v1/responses' \
  -H "Authorization: Bearer $DONGAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"model":"Qwen3.8-flash","input":"请用一句话解释人工智能","stream":false}'

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["DONGAI_API_KEY"], base_url="https://api.tongyuye.com/v1")
reply = client.chat.completions.create(model="Deepseek-v4-flash-0731-Official-key",
    messages=[{"role": "user", "content": "你好"}])
print(reply.choices[0].message.content)

import OpenAI from "openai";
const client = new OpenAI({apiKey: process.env.DONGAI_API_KEY, baseURL: "https://api.tongyuye.com/v1"});
const reply = await client.chat.completions.create({model: "Deepseek-v4-flash-0731-Official-key",
  messages: [{role: "user", content: "你好"}]});
console.log(reply.choices[0].message.content);

curl --fail-with-body --max-time 180 'https://api.tongyuye.com/v1/images/generations' \
  -H "Authorization: Bearer $DONGAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"model":"Seedream-4.5","prompt":"真实摄影，一只白色陶瓷杯放在木桌上，自然光","n":1}'

import os
import requests

BASE_URL = os.getenv("DONGAI_BASE_URL", "https://api.tongyuye.com/v1").rstrip("/")
HEADERS = {"Authorization": "Bearer " + os.environ["DONGAI_API_KEY"]}
import base64
from pathlib import Path

payload = {
  "model": "Seedream-4.5",
  "prompt": "真实摄影，一只白色陶瓷杯放在木桌上，自然光",
  "n": 1
}
response = requests.post(BASE_URL + "/images/generations", headers=HEADERS,
    json=payload, timeout=(10, 180), allow_redirects=False)
response.raise_for_status()
items = response.json().get("data", [])
if not items: raise RuntimeError("没有标准 data[] 图片结果，请核对模型返回格式")
for index, item in enumerate(items, 1):
    if item.get("b64_json"):
        Path(f"image-{index}.bin").write_bytes(base64.b64decode(item["b64_json"], validate=True))
        print("已保存图片字节；请根据实际图片格式设置文件扩展名")
    elif item.get("url"):
        print("图片地址（及时另行下载，勿携带本站密钥）：", item["url"])
    else:
        raise RuntimeError("结果缺少 url/b64_json，请核对模型返回格式")

curl --fail-with-body --max-time 180 'https://api.tongyuye.com/v1/images/edits' \
  -H "Authorization: Bearer $DONGAI_API_KEY" \
  --form-string 'model=Seedream-4.5' \
  -F "image=@reference.png" \
  --form-string "prompt=保留主体，将背景改为干净的摄影棚"

# 先生成并保存请求标识。同一逻辑请求重试时必须沿用此值和完全相同的请求体。
DONGAI_VIDEO_JOB_ID="$(python -c 'import uuid; print(uuid.uuid4())')"
printf "%s\n" "$DONGAI_VIDEO_JOB_ID" > video-idempotency-key.txt
curl --fail-with-body --max-time 180 'https://api.tongyuye.com/v1/videos/generations' \
  -H "Authorization: Bearer $DONGAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $DONGAI_VIDEO_JOB_ID" \
  --data-raw '{"model":"MiniMax-H3","prompt":"真实摄影，镜头缓慢推进蓝色灯光的服务器机房，无文字，无人物","duration":5,"resolution":"768p","ratio":"16:9"}'
# 保存 JSON 中的 id；连接中断时不要换新的请求标识重发。完整恢复流程见 Python。

{
  "id": "media_00000000000000000000000000000000",
  "task_id": "media_00000000000000000000000000000000",
  "object": "media.task",
  "kind": "video",
  "model": "MiniMax-H3",
  "status": "queued",
  "progress": null,
  "error": null,
  "content_type": null,
  "bytes": null,
  "sha256": null,
  "content_url": null,
  "content_path": null,
  "url": null,
  "result_url": null,
  "format": null,
  "created_at": "2026-10-20T00:00:00.000Z",
  "updated_at": "2026-10-20T00:00:00.000Z",
  "completed_at": null,
  "expires_at": "2026-10-20T00:30:00.000Z"
}

import os
import requests

BASE_URL = os.getenv("DONGAI_BASE_URL", "https://api.tongyuye.com/v1").rstrip("/")
HEADERS = {"Authorization": "Bearer " + os.environ["DONGAI_API_KEY"]}
import hashlib
import json
import time
import uuid
from pathlib import Path
from urllib.parse import quote

# 一个 job 文件对应一次付费生成；修改内容时使用新的文件名，并明确确认要创建新任务。
job_file = Path(os.getenv("DONGAI_VIDEO_JOB_FILE", "video-job.json"))
payload = {
  "model": "MiniMax-H3",
  "prompt": "真实摄影，镜头缓慢推进蓝色灯光的服务器机房，无文字，无人物",
  "duration": 5,
  "resolution": "768p",
  "ratio": "16:9"
}
body_hash = hashlib.sha256(json.dumps(payload, sort_keys=True, ensure_ascii=False).encode()).hexdigest()
key_fingerprint = hashlib.sha256(os.environ["DONGAI_API_KEY"].encode()).hexdigest()
initial_job = {"idempotency_key": str(uuid.uuid4()), "body_hash": body_hash, "base_url": BASE_URL, "key_fingerprint": key_fingerprint}
try:
    # 独占创建，两个进程不会各自分配不同的付费请求标识。文件中从不保存原始密钥。
    with job_file.open("x", encoding="utf-8") as target: json.dump(initial_job, target)
except FileExistsError:
    pass
job = json.loads(job_file.read_text(encoding="utf-8"))
if job.get("body_hash") != body_hash or job.get("base_url") != BASE_URL or job.get("key_fingerprint") != key_fingerprint:
    raise RuntimeError("job 文件属于不同请求、服务地址或密钥；请用原配置恢复，勿自动新建付费任务")
if not job.get("task_id"):
    response = requests.post(BASE_URL + "/videos/generations",
        headers={**HEADERS, "Idempotency-Key": job["idempotency_key"]}, json=payload,
        timeout=(10, 90), allow_redirects=False)
    if response.status_code not in (200, 202):
        raise RuntimeError(f"创建未确认：HTTP {response.status_code} {response.text[:800]}；保留 job 文件核对")
    task = response.json()
    job["task_id"] = task["id"]
    job_file.write_text(json.dumps(job), encoding="utf-8")
task_path = "/media/tasks/" + quote(job["task_id"], safe="")
deadline = time.monotonic() + 20 * 60
while time.monotonic() < deadline:
    response = requests.get(BASE_URL + task_path, headers=HEADERS,
        timeout=(10, 30), allow_redirects=False)
    if response.status_code == 429:
        delay = response.headers.get("Retry-After", "5")
        time.sleep(min(60, max(5, int(delay))) if delay.isdigit() else 5)
        continue
    response.raise_for_status()
    task = response.json()
    print(task["id"], task["status"], task.get("progress"))
    if task["status"] == "succeeded": break
    if task["status"] in ("failed", "cancelled", "expired"):
        raise RuntimeError(json.dumps(task.get("error"), ensure_ascii=False))
    time.sleep(5)
else:
    raise TimeoutError("停止本地等待；任务可能仍在执行。保留 job 文件，下次运行恢复查询，不重新生成")

# 用本站固定路径和同一密钥下载，绝不向第三方 content_url 转发密钥。
with requests.get(BASE_URL + task_path + "/content", headers=HEADERS,
        timeout=(10, 90), stream=True, allow_redirects=False) as response:
    response.raise_for_status()
    content_type = response.headers.get("Content-Type", "").split(";", 1)[0]
    if not content_type.startswith("video/"):
        raise RuntimeError("下载并非视频内容，拒绝将错误页面当作视频保存")
    extension = {"video/mp4": ".mp4", "video/webm": ".webm", "video/quicktime": ".mov"}.get(content_type, ".bin")
    output = Path("result" + extension)
    temporary = output.with_suffix(output.suffix + ".part")
    checksum = hashlib.sha256()
    with temporary.open("wb") as target:
        for chunk in response.iter_content(1024 * 1024):
            if chunk: target.write(chunk); checksum.update(chunk)
    if task.get("sha256") and checksum.hexdigest() != task["sha256"]:
        temporary.unlink(missing_ok=True)
        raise RuntimeError("SHA-256 校验失败；请重试下载原任务，不重新生成")
    os.replace(temporary, output)
    print("已保存：", output)

curl --fail-with-body --max-time 180 'https://api.tongyuye.com/v1/embeddings' \
  -H "Authorization: Bearer $DONGAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"model":"PUBLIC_EMBEDDING_MODEL","input":"人工智能知识检索"}'

curl --fail-with-body --max-time 180 'https://api.tongyuye.com/v1/rerank' \
  -H "Authorization: Bearer $DONGAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"model":"PUBLIC_RERANK_MODEL","query":"如何接入模型服务","documents":["通过 API 密钥调用公开模型","今天的天气很好"],"top_n":1}'

curl --fail-with-body --max-time 180 'https://api.tongyuye.com/v1/moderations' \
  -H "Authorization: Bearer $DONGAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"model":"PUBLIC_MODERATION_MODEL","input":"待检查的文本"}'

curl --fail-with-body --max-time 180 'https://api.tongyuye.com/v1/audio/speech' \
  -H "Authorization: Bearer $DONGAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"model":"PUBLIC_TTS_MODEL","input":"欢迎使用懂AI","voice":"YOUR_SUPPORTED_VOICE","response_format":"mp3"}' \
  --output speech.mp3

curl --fail-with-body --max-time 180 'https://api.tongyuye.com/v1/audio/transcriptions' \
  -H "Authorization: Bearer $DONGAI_API_KEY" \
  --form-string 'model=PUBLIC_ASR_MODEL' \
  -F "file=@speech.wav"