集成文档

from openai import OpenAI

client = OpenAI(
    api_key="sk-…",                       # portal /keys
    base_url="https://ai.silkroadai.io/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.4",
    max_tokens=4096,                      # Claude 系建议 ≤4096 避免上游 502
    messages=[{"role": "user", "content": "你好,介绍一下丝绸之路"}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-…",                         // portal /keys
  baseURL: "https://ai.silkroadai.io/v1",
});

const completion = await client.chat.completions.create({
  model: "claude-sonnet-4-6",
  max_tokens: 4096,
  messages: [{ role: "user", content: "Hello" }],
});
console.log(completion.choices[0].message.content);

curl -X POST https://ai.silkroadai.io/v1/chat/completions \
  -H "Authorization: Bearer sk-…" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "max_tokens": 4096,
    "messages": [{"role":"user","content":"Hello"}]
  }'

curl -X POST https://ai.silkroadai.io/v1/messages \
  -H "x-api-key: sk-…" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-7",
    "max_tokens": 4096,
    "messages": [{"role":"user","content":"Hello"}]
  }'

# 文生图 — 用哪个模型就拿哪档分辨率(2.5=1K / 3.1=2K / 3-pro=4K)
curl https://ai.silkroadai.io/v1/chat/completions \
  -H "Authorization: Bearer sk-你的KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "messages": [{ "role": "user", "content": "一只戴帽子的橘猫,水彩风格" }]
  }'
# 响应 choices[0].message.content = "![image](https://images.silkroadai.io/gen/….png)"

{ "role": "user", "content": [
  { "type": "text", "text": "给这只猫戴一顶圣诞帽" },
  { "type": "image_url", "image_url": { "url": "data:image/jpeg;base64,<BASE64>" } }
] }

# 2K — gemini-3.1-flash-image-preview
curl -X POST "https://ai.silkroadai.io/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "Authorization: Bearer sk-…" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "parts": [{ "text": "A calico cat on a window sill" }] }],
    "generationConfig": { "imageConfig": { "imageSize": "2K", "aspectRatio": "1:1" } }
  }'

# 4K — gemini-3-pro-image-preview(把 imageSize 改成 "4K")
curl -X POST "https://ai.silkroadai.io/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer sk-…" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "parts": [{ "text": "A calico cat on a window sill" }] }],
    "generationConfig": { "imageConfig": { "imageSize": "4K", "aspectRatio": "1:1" } }
  }'

from google import genai
from google.genai import types

client = genai.Client(
    api_key="sk-…",
    http_options=types.HttpOptions(base_url="https://ai.silkroadai.io"),
)

resp = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="A calico cat sitting on a window sill",
    config=types.GenerateContentConfig(
        image_config=types.ImageConfig(image_size="2K", aspect_ratio="1:1"),
    ),
)
for part in resp.candidates[0].content.parts:
    if part.inline_data:
        open("output.jpg", "wb").write(part.inline_data.data)

# 文生图 — /v1/images/generations(显式比例)
curl https://ai.silkroadai.io/v1/images/generations \
  -H "Authorization: Bearer sk-你的KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "赛博朋克城市夜景,雨后霓虹",
    "aspect_ratio": "16:9",
    "response_format": "url"
  }'

# 改图 — /v1/images/edits(multipart;image 可重复传多张参考图,也支持 JSON + data URL)
curl https://ai.silkroadai.io/v1/images/edits \
  -H "Authorization: Bearer sk-你的KEY" \
  -F model="gemini-3-pro-image-preview" \
  -F prompt="把这两张人物合到同一个海边场景" \
  -F aspect_ratio="3:2" \
  -F image=@person1.png \
  -F image=@person2.png

curl https://ai.silkroadai.io/v1/images/generations \
  -H "Authorization: Bearer sk-你的KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴圣诞帽的橘猫,工作室灯光,高细节",
    "size": "1536x1024",
    "quality": "high"
  }'

from openai import OpenAI
import base64

client = OpenAI(api_key="sk-你的KEY", base_url="https://ai.silkroadai.io/v1")

resp = client.images.generate(
    model="gpt-image-2",
    prompt="一只戴圣诞帽的橘猫,工作室灯光,高细节",
    size="1536x1024",
)
with open("out.png", "wb") as f:
    f.write(base64.b64decode(resp.data[0].b64_json))

import OpenAI from "openai";
import fs from "node:fs";

const client = new OpenAI({ apiKey: "sk-你的KEY", baseURL: "https://ai.silkroadai.io/v1" });

const resp = await client.images.generate({
  model: "gpt-image-2",
  prompt: "一只戴圣诞帽的橘猫,工作室灯光,高细节",
  size: "1536x1024",
});
fs.writeFileSync("out.png", Buffer.from(resp.data[0].b64_json, "base64"));

curl https://ai.silkroadai.io/v1/images/edits \
  -H "Authorization: Bearer sk-你的KEY" \
  -F model=gpt-image-2 \
  -F prompt="把背景换成雪景" \
  -F image=@cat.png

from openai import OpenAI
import base64

client = OpenAI(api_key="sk-你的KEY", base_url="https://ai.silkroadai.io/v1")

resp = client.images.edit(
    model="gpt-image-2",
    prompt="把背景换成雪景",
    image=open("cat.png", "rb"),
)
with open("edited.png", "wb") as f:
    f.write(base64.b64decode(resp.data[0].b64_json))

{
  "created": 1781523778,
  "data": [{ "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." }]
}

curl https://ai.silkroadai.io/v1/video/generations \
  -H "Authorization: Bearer 你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-720",
    "prompt": "霓虹雨夜街头的电影感跟拍镜头,缓慢推进,35mm 颗粒",
    "aspect_ratio": "16:9",
    "seconds": "10"
  }'
# → { "task_id": "task_xxx", "object": "video", "status": "queued" }

curl https://ai.silkroadai.io/v1/video/generations/task_xxx -H "Authorization: Bearer 你的key"
# status: in_progress … 几分钟后 "status": "completed"
# 视频直链在响应的 video_url 字段(公网 .mp4)

curl https://ai.silkroadai.io/v1/video/generations \
  -H "Authorization: Bearer 你的key" -H "Content-Type: application/json" \
  -d '{ "model": "seedance-2.0-720", "prompt": "@Image1 的人物开始走路,镜头跟随推进", "seconds": "10",
        "image_url": "https://你的图床/start.jpg" }'

curl https://ai.silkroadai.io/v1/video/generations \
  -H "Authorization: Bearer 你的key" -H "Content-Type: application/json" \
  -d '{ "model": "seedance-2.0-1080",
        "prompt": "@Image1 的角色,在 @Image2 的场景里跳舞,宽银幕镜头",
        "aspect_ratio": "21:9", "seconds": "15",
        "reference_image_urls": ["https://你的图床/role.jpg", "https://你的图床/scene.jpg"] }'

curl https://ai.silkroadai.io/v1/video/generations \
  -H "Authorization: Bearer 你的key" -H "Content-Type: application/json" \
  -d '{ "model": "seedance-2.0-720", "prompt": "从这个画面开始,镜头缓慢推进,人物转身", "seconds": "10",
        "image_url": "https://你的图床/start.jpg", "video_config": { "reference_mode": "start_frame" } }'

curl https://ai.silkroadai.io/v1/video/generations \
  -H "Authorization: Bearer 你的key" -H "Content-Type: application/json" \
  -d '{ "model": "seedance-2.0-720", "prompt": "从第一张画面平滑过渡到第二张,自然运镜", "seconds": "10",
        "reference_image_urls": ["https://你的图床/first.jpg", "https://你的图床/last.jpg"],
        "video_config": { "reference_mode": "start_end" } }'

curl https://ai.silkroadai.io/v1/video/generations \
  -H "Authorization: Bearer 你的key" -H "Content-Type: application/json" \
  -d '{ "model": "seedance-2.0-720",
        "prompt": "@Image1 角色随 @Audio1 的节奏起舞,运镜参考 @Video1", "seconds": "15",
        "reference_image_urls": ["https://你的图床/role.jpg"],
        "reference_videos": ["https://你的视频/camera.mp4"],
        "audio_url": "https://你的音频/track.mp3" }'

import time, requests

BASE = "https://ai.silkroadai.io/v1/video/generations"
H = {"Authorization": "Bearer 你的key", "Content-Type": "application/json"}

task = requests.post(BASE, headers=H, json={
    "model": "seedance-2.0-720",
    "prompt": "一只橘猫在窗台上伸懒腰,慢镜头,暖色调",
    "aspect_ratio": "16:9", "seconds": "10",
}).json()
tid = task.get("task_id") or task.get("id")

def pick(d):  # 递归找视频直链
    out = None
    def w(n):
        nonlocal out
        if isinstance(n, dict):
            v = n.get("video_url")
            if isinstance(v, str) and v.startswith("http") and not out: out = v
            for x in n.values(): w(x)
        elif isinstance(n, list):
            for x in n: w(x)
    w(d); return out

for _ in range(120):  # 最多约 16 分钟
    r = requests.get(f"{BASE}/{tid}", headers=H).json()
    st = str(r.get("data", {}).get("status") or r.get("status") or "").lower()
    if st in ("completed", "success", "failed", "failure"):
        print(st, "→", pick(r)); break
    time.sleep(8)

curl https://ai.silkroadai.io/v1/video/generations \
  -H "Authorization: Bearer sk-你的海外满血KEY" -H "Content-Type: application/json" \
  -d '{ "model": "dreamina-seedance-2-0-720p", "prompt": "一只橘猫在窗台伸懒腰,暖色调", "duration": 5 }'

curl https://ai.silkroadai.io/v1/video/generations -H "Authorization: Bearer sk-你的海外满血KEY" \
  -H "Content-Type: application/json" -d '{ "model": "dreamina-seedance-2-0-720p-ref",
  "prompt": "镜头缓缓推进,画面动起来", "duration": 5, "image": "https://你的图床/photo.jpg" }'
# image 支持 http 链接或 base64 data URL;多图用 images:[...](≤9);也兼容 image_url / reference_image_urls

curl https://ai.silkroadai.io/v1/video/generations -H "Authorization: Bearer sk-你的海外满血KEY" \
  -H "Content-Type: application/json" -d '{ "model": "dreamina-seedance-2-0-720p-ref",
  "prompt": "从第一张平滑过渡到第二张", "duration": 5,
  "first_frame": "https://你的图床/first.jpg", "last_frame": "https://你的图床/last.jpg" }'

curl https://ai.silkroadai.io/v1/video/generations -H "Authorization: Bearer sk-你的海外满血KEY" \
  -H "Content-Type: application/json" -d '{ "model": "dreamina-seedance-2-0-720p-ref",
  "prompt": "这个人随节奏唱歌", "duration": 5, "image": "https://你的图床/singer.jpg",
  "audio_url": "https://你的音频/song.mp3" }'
# 用音频时必须同时带至少一张图

curl https://ai.silkroadai.io/v1/video/generations -H "Authorization: Bearer sk-你的海外满血KEY" \
  -H "Content-Type: application/json" -d '{ "model": "dreamina-seedance-2-0-720p-ref",
  "prompt": "运镜参考 @Video1,把场景换成雪天", "duration": 5,
  "reference_videos": ["https://你的视频/camera.mp4"] }'
# reference_videos 数组(≤3);可与参考图同用,prompt 里 @Video1 / @Image1 指代

curl https://ai.silkroadai.io/v1/video/generations/task_xxx -H "Authorization: Bearer sk-你的海外满血KEY"
# data.status=SUCCESS 后,视频在 data.data.video_url(或 result_url,等价)

import time, requests

BASE = "https://ai.silkroadai.io/v1"
KEY  = "你的 seedance海外满血 key"
H = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

# 图生(参考图);文生去掉 image、换不带 -ref 的模型即可
task = requests.post(f"{BASE}/video/generations", headers=H, json={
    "model": "dreamina-seedance-2-0-720p-ref",
    "prompt": "镜头缓缓推进,画面动起来",
    "duration": 5,
    "image": "https://你的图床/photo.jpg",
}).json()
tid = task.get("task_id") or task.get("id")

def pick(d):  # 递归找视频直链
    out = None
    def w(n):
        nonlocal out
        if isinstance(n, dict):
            v = n.get("video_url")
            if isinstance(v, str) and v.startswith("http") and not out: out = v
            for x in n.values(): w(x)
        elif isinstance(n, list):
            for x in n: w(x)
    w(d); return out

for _ in range(120):  # 最多约 10 分钟
    r = requests.get(f"{BASE}/video/generations/{tid}", headers=H).json()
    st = str(r.get("data", {}).get("status") or r.get("status") or "").upper()
    if st in ("SUCCESS", "FAILURE", "FAILED"):
        print(st, "→", pick(r) or r.get("data", {}).get("result_url")); break
    time.sleep(8)