统一接口，接入主流大模型

import requests

resp = requests.post(
    "https://api.example.com/v1/messages",
    headers={
        "x-api-key": "<YOUR_API_KEY>",
        "anthropic-version": "2023-06-01",
        "content-type": "application/json",
    },
    json={
        "model": "claude-sonnet-4-6",
        "max_tokens": 1024,
        "messages": [
            {"role": "user", "content": "请用一句话介绍你自己"}
        ],
    },
    timeout=120,
)

resp.raise_for_status()
print(resp.json()["content"][0]["text"])

from openai import OpenAI

client = OpenAI(
    api_key="<YOUR_API_KEY>",
    base_url="https://api.example.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.4",
    messages=[
        {"role": "user", "content": "请用一句话介绍你自己"}
    ],
    max_tokens=512,
)

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

import requests

resp = requests.post(
    "https://api.example.com/v1beta/models/gemini-3.5-flash:generateContent",
    headers={
        "x-goog-api-key": "<YOUR_API_KEY>",
        "Content-Type": "application/json",
    },
    json={
        "contents": [
            {
                "parts": [
                    {"text": "请用一句话介绍你自己"}
                ]
            }
        ]
    },
    timeout=120,
)

resp.raise_for_status()
print(resp.json()["candidates"][0]["content"]["parts"][0]["text"])

# 图像编辑接口必须使用 multipart/form-data，不是 JSON
# image 可上传 1 张或多张图片；可用于修改原图，也可作为参考图生成新图
curl "https://api.example.com/v1/images/edits" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -F "model=gpt-image-2" \
  -F "prompt=保留人物姿势和服装，把背景改成傍晚海边，整体电影感" \
  -F "image[]=@input.png" \
  -F "size=1024x1024" \
  -F "quality=medium" \
  -F "output_format=png"

# mask 用于提示要重绘的区域；mask 与第一张 image 尺寸一致，并带 alpha 通道
# GPT Image 的 mask 是提示性约束，模型可能不会像传统修图工具一样逐像素严格遵守
curl "https://api.example.com/v1/images/edits" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -F "model=gpt-image-2" \
  -F "prompt=只替换透明遮罩区域：把桌上的空杯子改成一杯拿铁，其他区域保持不变" \
  -F "image=@input.png" \
  -F "mask=@mask.png" \
  -F "size=1024x1024" \
  -F "quality=high"

import base64
import requests

resp = requests.post(
    "https://api.example.com/v1/images/edits",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
    data={
        "model": "gpt-image-2",
        "prompt": "把图片改成水彩插画风格，保持主体构图不变",
        "size": "1024x1024",
        "quality": "medium",
        "output_format": "png",
    },
    files={"image": open("input.png", "rb")},
    timeout=180,
)

resp.raise_for_status()
image_b64 = resp.json()["data"][0]["b64_json"]

with open("output.png", "wb") as f:
    f.write(base64.b64decode(image_b64))

# 图片必须通过公网可访问 URL 提供
curl -X POST "https://api.example.com/v1/videos" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-i2v",
    "input": {
      "prompt": "让图片中的人物自然挥手，背景保持稳定",
      "media": [
        {
          "type": "input_image",
          "url": "https://example.com/input.jpg"
        }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "duration": 5,
      "watermark": false
    }
  }'

# 参考图片必须通过公网可访问 URL 提供
curl -X POST "https://api.example.com/v1/videos" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-r2v",
    "input": {
      "prompt": "[Image 1]中的人物向镜头挥手，保持人物特征一致",
      "media": [
        {
          "type": "reference_image",
          "url": "https://example.com/reference-1.jpg"
        },
        {
          "type": "reference_image",
          "url": "https://example.com/reference-2.jpg"
        }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "duration": 3,
      "ratio": "16:9",
      "watermark": false
    }
  }'

# 输入视频必须通过公网可访问 URL 提供
# duration 放在顶层，用于计费用时；media.type 使用 video
curl -X POST "https://api.example.com/v1/videos" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-video-edit",
    "duration": 3,
    "input": {
      "prompt": "将视频调整为电影感暖色调，保持主体动作自然",
      "media": [
        {
          "type": "video",
          "url": "https://example.com/input.mp4"
        }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "watermark": false,
      "audio_setting": "origin"
    }
  }'

curl "https://api.example.com/v1/videos/<task_id>" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

curl "https://api.example.com/v1/video/generations" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "以图片1作为首帧、图片2作为尾帧，生成一段自然流畅的产品转场视频，保持主体一致",
    "content": [
      {
        "type": "text",
        "text": "以图片1作为首帧、图片2作为尾帧，生成一段自然流畅的产品转场视频，保持主体一致"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/first-frame.jpg"
        },
        "role": "first_frame"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/last-frame.jpg"
        },
        "role": "last_frame"
      }
    ],
    "resolution": "720p",
    "ratio": "adaptive",
    "duration": 4,
    "generate_audio": false,
    "watermark": false,
    "return_last_frame": true
  }'

curl "https://api.example.com/v1/video/generations" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "参考图片1的人物外观、参考视频1的镜头运动、参考音频1的节奏，生成一段电影感短视频",
    "content": [
      {
        "type": "text",
        "text": "参考图片1的人物外观、参考视频1的镜头运动、参考音频1的节奏，生成一段电影感短视频"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/reference-image.jpg"
        },
        "role": "reference_image"
      },
      {
        "type": "video_url",
        "video_url": {
          "url": "https://example.com/reference-video.mp4"
        },
        "role": "reference_video"
      },
      {
        "type": "audio_url",
        "audio_url": {
          "url": "https://example.com/reference-audio.mp3"
        },
        "role": "reference_audio"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 4,
    "generate_audio": true,
    "watermark": false
  }'

curl "https://api.example.com/v1/video/generations/<task_id>" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

import requests

resp = requests.post(
    "https://api.example.com/v1/audio/speech",
    headers={
        "Authorization": "Bearer <YOUR_API_KEY>",
        "Content-Type": "application/json",
    },
    json={
        "model": "qwen3-tts-flash",
        "input": "你好，这是一个测试。",
        "voice": "Cherry",
    },
    timeout=180,
)

resp.raise_for_status()
with open("speech.wav", "wb") as f:
    f.write(resp.content)