视频生成

import time

from openai import OpenAI

client = OpenAI(
    base_url="https://api.goodputai.cn/v1",
    api_key="你的 GoodPut API Key",
)


def generate(**kwargs) -> str:
    """提交 → 轮询 → 下载，返回落盘路径。所有模式共用。"""
    video = client.videos.create(**kwargs)
    print(video.id, video.status)          # video_xxx queued

    deadline = time.time() + 15 * 60       # 整体超时，别无限轮询
    while video.status in ("queued", "in_progress"):
        if time.time() > deadline:
            raise TimeoutError(f"超时未完成：{video.id}")
        time.sleep(5)
        video = client.videos.retrieve(video.id)

    if video.status != "completed":
        raise RuntimeError(f"生成失败：{video.error}")

    path = f"{video.id[:16]}.mp4"
    client.videos.download_content(video.id).write_to_file(path)
    print("usage:", video.usage)           # 计费依据
    return path


# 最简：文生视频
generate(
    model="wan/wan3.0-video",
    prompt="海边日出，海浪拍打礁石，电影感运镜",
    size="1280x720",
    seconds="5",
)

# 1) 提交任务 —— 返回体里的 id 就是后续查询用的任务 id
curl https://api.goodputai.cn/v1/videos \
  -H "Authorization: Bearer $GOODPUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan/wan3.0-video",
    "prompt": "海边日出，海浪拍打礁石",
    "size": "1280x720",
    "seconds": "5"
  }'

# 2) 轮询状态，直到 status 变成 completed 或 failed
curl https://api.goodputai.cn/v1/videos/{video_id} \
  -H "Authorization: Bearer $GOODPUT_API_KEY"

# 3) 下载成片（二进制流，直接落盘）
curl https://api.goodputai.cn/v1/videos/{video_id}/content \
  -H "Authorization: Bearer $GOODPUT_API_KEY" \
  -o output.mp4

generate(
    model="wan/wan3.0-video",     # 或 wan/wan2.7-t2v、wan/wan2.6-t2v
    prompt="霓虹街道，雨夜，第一人称视角向前行走",
    size="720x1280",              # 短边 720 → 720P 档；9:16 → 竖屏
    seconds="5",
    prompt_extend=False,          # ⚠️ 默认 true 会改写你的提示词
)

generate(
    model="minimax/h3",
    prompt="霓虹街道，雨夜，第一人称视角向前行走。无字幕，无文字。",
    size="768x1344",              # 9:16 竖屏，见下面的六种画布
    seconds=6,                    # 4~15 的整数
)

generate(
    model="wan/wan2.7-i2v",       # 或 wan/wan3.0-video
    prompt="镜头缓缓拉远",
    # 链接 / base64 要放进 extra_body（原因见下方说明）
    extra_body={"input_reference": "https://example.com/first.jpg"},
    size="1280x720",              # 决定档位与单价；⚠️ 实际画幅跟随这张图
    seconds="5",
)

# 形式一：公网 URL 或 data: 内联 —— 放进 extra_body
generate(
    model="minimax/h3",
    prompt="镜头缓缓拉远，人物自然转身",
    extra_body={"input_reference": "https://example.com/first.jpg"},
    size="768x768",
    seconds=4,
)

# 形式二：直接上传本地文件（h3 支持，wan 不支持）
with open("first.jpg", "rb") as f:
    generate(
        model="minimax/h3",
        prompt="镜头缓缓拉远，人物自然转身",
        input_reference=f,
        size="768x768",
        seconds=4,
    )

generate(
    model="wan/wan2.7-r2v",       # 或 wan/wan3.0-video
    prompt="同一个角色在雪地里行走",
    extra_body={
        "media": [
            {"type": "reference_image", "url": "https://example.com/character.jpg"},
        ]
    },
    size="1280x720",
    seconds="5",
)

# h3 可以一次给多张参考图
generate(
    model="minimax/h3",
    prompt="这个房间里，一名女子从左侧走入并掀开箱笼",
    extra_body={
        "media": [
            {"type": "reference_image", "url": "https://example.com/room.jpg"},
            {"type": "reference_image", "url": "https://example.com/person.jpg"},
        ]
    },
    size="1344x768",
    seconds=4,
)

generate(
    model="wan/wan3.0-video",
    prompt="从白天过渡到夜晚",
    extra_body={
        "media": [
            {"type": "first_frame", "url": "https://example.com/day.jpg"},
            {"type": "last_frame", "url": "https://example.com/night.jpg"},
        ]
    },
    size="1280x720",
    seconds="5",
)

generate(
    model="minimax/h3",
    prompt="人物动作自然连贯地从起始姿态过渡到结束姿态",
    extra_body={
        "media": [
            {"type": "first_frame", "url": "https://example.com/start.jpg"},
            {"type": "last_frame", "url": "https://example.com/end.jpg"},
        ]
    },
    size="1344x768",
    seconds=4,
)

{
  "duration_seconds": 5,      // 实际成片秒数 —— 按这个计费
  "SR": 480,                  // 实际出片的分辨率档位 —— 决定单价
  "ratio": "16:9",
  "fps": 30,
  "video_count": 1
}

{
  "duration_seconds": 4,      // = 你请求的 seconds，按这个计费
  "size": "768x768",
  "inference_time_s": 54.8    // 本次生成耗时，仅供参考，不参与计费
}

{
  "duration_seconds": 5,      // = 你请求的 seconds（请求 15 时回 14），按这个计费
  "size": "1344x768",
  "inference_time_s": 17.9    // 本次生成耗时，仅供参考，不参与计费
}