Skip to main content

Integrasikan model generasi video

Panggil model generasi video Token Plan dari alat Agent, kirim tugas asinkron, dan unduh video setelah proses generasi selesai.

Model yang didukung

ModelInputDeskripsi
happyhorse-1.1-t2vTeksTeks ke video
happyhorse-1.1-i2vGambar bingkai pertama, teksGambar ke video
happyhorse-1.1-r2vGambar referensi, teksReferensi ke video
wan3.0-videoTeks, gambar, atau materi referensiPembuatan video semua dalam satu
Untuk model lainnya, lihat model yang didukung oleh Token Plan.

Prasyarat

  • Langganan Token Plan dan API key yang diawali dengan sk-sp-. Untuk detailnya, lihat Ikhtisar integrasi.
  • Python 3.9 atau yang lebih baru.
  • Alat coding AI Anda mendukung Slash Commands. Untuk jalur konfigurasi alat lainnya, lihat Alat lainnya.

Antarmuka

Kirim tugas: POST https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis Kueri tugas: GET https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} Gunakan Authorization: Bearer $ANTHROPIC_AUTH_TOKEN di header permintaan. Tambahkan X-DashScope-Async: enable saat mengirim tugas.

Langkah 1: Buat Slash Command

Konfigurasikan Token Plan API key sebagai environment variable $ANTHROPIC_AUTH_TOKEN. Buat .claude/commands/text-to-video.md di root proyek dan tambahkan konten berikut:
Panggil API pembuatan video Token Plan, kirim tugas text-to-video, tunggu hingga selesai, lalu unduh video tersebut.

Deskripsi video: $ARGUMENTS

## Langkah

1. Ekstrak prompt (deskripsi video), model (default: happyhorse-1.1-t2v), resolusi (default: 720P), rasio (default: 16:9), dan durasi (default: 5) dari deskripsi. Jika deskripsi menentukan model, gunakan model tersebut.
2. Instal dependensi: pip install requests
3. Gunakan tool Bash untuk menjalankan skrip Python berikut. Skrip membaca TOKEN_PLAN_API_KEY terlebih dahulu, lalu ANTHROPIC_AUTH_TOKEN. Jangan menampilkan key atau menulisnya ke file atau log.

```python
import json
import os
import sys
import time
from pathlib import Path

import requests

prompt = " ".join(sys.argv[1:])
key = os.environ.get("TOKEN_PLAN_API_KEY") or os.environ.get("ANTHROPIC_AUTH_TOKEN")
if not key:
    raise SystemExit("Token Plan API Key not found.")

base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com"
headers = {"Authorization": f"Bearer {key}", "Content-Type": "application/json"}

response = requests.post(
    f"{base_url}/api/v1/services/aigc/video-generation/video-synthesis",
    headers={**headers, "X-DashScope-Async": "enable"},
    json={
        "model": "happyhorse-1.1-t2v",
        "input": {"prompt": prompt},
        "parameters": {"resolution": "720P", "ratio": "16:9", "duration": 5},
    },
    timeout=60,
)
if not response.ok:
    raise SystemExit(f"{response.status_code}: {response.text}")
task_id = response.json()["output"]["task_id"]
print(f"Task submitted: {task_id}")

while True:
    time.sleep(10)
    result = requests.get(f"{base_url}/api/v1/tasks/{task_id}", headers=headers, timeout=60)
    if not result.ok:
        raise SystemExit(f"{result.status_code}: {result.text}")
    data = result.json()
    status = data["output"]["task_status"]
    if status == "SUCCEEDED":
        video_url = data["output"]["video_url"]
        output = f"generated_{time.strftime('%Y%m%d_%H%M%S')}.mp4"
        video = requests.get(video_url, timeout=120)
        video.raise_for_status()
        Path(output).write_bytes(video.content)
        print(output)
        break
    if status in {"FAILED", "CANCELED", "UNKNOWN"}:
        raise SystemExit(json.dumps(data, ensure_ascii=False, indent=2))
    print(f"Task status: {status}")
```

4. Tampilkan path file video yang diunduh.

Langkah 2: Buat video

Di Claude Code, masukkan /text-to-video a white cat sitting on a balcony in the sun. Untuk menyesuaikan durasi, resolusi, atau rasio aspek, tentukan dalam perintah, misalnya /text-to-video generate a 10-second, 1080P, 9:16 city night scene.

Parameter permintaan

ParameterWajibDeskripsi
modelYaID model pembuatan video.
input.promptYaDeskripsi video.
parameters.resolutionTidakResolusi. Mendukung 480P, 720P, dan 1080P. Default: 1080P.
parameters.ratioTidakRasio aspek. Mendukung 16:9, 9:16, 1:1, dan lainnya. Default: 16:9.
parameters.durationTidakDurasi dalam detik, dari 3 hingga 15. Default: 5.
Untuk parameter lainnya, lihat API text-to-video HappyHorse.

Respons

  • Mengirim tugas akan mengembalikan output.task_id dan output.task_status.
  • Lakukan polling terhadap GET /api/v1/tasks/{task_id}. Jika statusnya SUCCEEDED, respons berisi output.video_url.
  • Status tugas mencakup PENDING, RUNNING, SUCCEEDED, FAILED, CANCELED, dan UNKNOWN.
  • URL video akan kedaluwarsa. Segera unduh video tersebut.

Batasan

  • Pembuatan video bersifat asinkron. Kirim task lalu lakukan polling untuk hasilnya. task_id berlaku selama 24 jam.
  • Jenis input, resolusi, durasi, dan rasio aspek yang didukung berbeda-beda tergantung model. Lihat dokumentasi masing-masing model.
  • Pembuatan video mengonsumsi lebih banyak Credits dibandingkan pembuatan gambar dan sintesis suara. Konsumsi Credits aktual ditampilkan di Usage di konsol.

Alat lainnya

Untuk mekanisme ekstensi dan jalur konfigurasi alat lainnya, lihat Ikhtisar integrasi. Simpan Slash Command di atas ke jalur yang sesuai.