ตัวอย่างรูปภาพและวิดีโอ

ใช้ Facade host และ Prism API key เดียวกับ chat completions:

export PRISM_BASE_URL="https://api.prismgateway.io/v1"
export PRISM_API_KEY="sk-prism-..."

ใช้ GET /v1/models หรือ console model catalog เพื่อเลือก public model ID ที่ org ของคุณมองเห็น ตัวอย่างด้านล่างแสดง request shape ที่รองรับ ให้แทนที่ model ID ด้วย ID ที่ publish จริงใน catalog ของคุณ

สร้างรูปภาพ

POST /v1/images/generations รับ OpenAI-style image generation body โดย Facade จะตรวจ customer key, catalog visibility, credits แล้ว route ไป image runtime ที่ตั้งค่าไว้

curl -sS "$PRISM_BASE_URL/images/generations" \
  -H "Authorization: Bearer $PRISM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-260128",
    "prompt": "A clean product render of a translucent prism gateway device on a white desk",
    "size": "1024x1024",
    "n": 1
  }'

เมื่อ runtime รองรับ response จะเป็น OpenAI image shape:

{
  "created": 1779091200,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

Text-to-video

สร้าง video job ด้วย POST /v1/video/generations วิดีโอเป็น async ให้เก็บ job ID ที่ได้กลับมา แล้ว poll ด้วย GET /v1/video/generations/{jobId}

curl -sS "$PRISM_BASE_URL/video/generations" \
  -H "Authorization: Bearer $PRISM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-1.0-pro-fast",
    "prompt": "A cinematic dolly shot through a glass API gateway room, soft reflections, product demo style",
    "duration": 5,
    "resolution": "1080p",
    "aspectRatio": "16:9",
    "generateAudio": true
  }'

Image-to-video

ส่ง hosted image URL ไปพร้อม video request ได้ prompt ใช้อธิบาย motion ส่วน media-only requests รองรับใน video runtime ที่รองรับ image หรือ reference inputs

curl -sS "$PRISM_BASE_URL/video/generations" \
  -H "Authorization: Bearer $PRISM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-1.0-pro-fast",
    "prompt": "Animate the product with a slow clockwise camera move and subtle light sweep",
    "imageUrl": "https://cdn.example.com/prism/product-frame.png",
    "duration": 5,
    "resolution": "1080p",
    "aspectRatio": "16:9"
  }'

HappyHorse 1.1 text-to-video

HappyHorse 1.1 เป็น video model ใหม่ล่าสุดจาก Alibaba มี cinematic lighting, กล้องนิ่ง, และสร้าง audio ได้ในตัว ใช้ happyhorse-1.1-t2v สำหรับ text-to-video

curl -sS "$PRISM_BASE_URL/video/generations" \
  -H "Authorization: Bearer $PRISM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-t2v",
    "prompt": "A cinematic aerial shot of a tropical island at golden hour, lush vegetation and crystal-clear water",
    "duration": 5,
    "resolution": "1080p",
    "aspectRatio": "16:9",
    "generateAudio": true
  }'

HappyHorse reference-to-video

HappyHorse-compatible request shapes รองรับ imageUrls สำหรับ multi-reference video generation และ audio controls เช่น generateAudio กับ refAudioUrl

curl -sS "$PRISM_BASE_URL/video/generations" \
  -H "Authorization: Bearer $PRISM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-r2v",
    "imageUrls": [
      "https://cdn.example.com/character/front.png",
      "https://cdn.example.com/character/side.png"
    ],
    "prompt": "A short studio walk cycle with consistent character identity",
    "generateAudio": true,
    "refAudioUrl": "https://cdn.example.com/audio/reference-voice.wav"
  }'

Video edit

สำหรับ video edit models ให้ส่ง refVideoUrl ส่วน prompt ใช้อธิบาย edit intent ได้ แต่ media input คือ anchor หลักของคำขอ

curl -sS "$PRISM_BASE_URL/video/generations" \
  -H "Authorization: Bearer $PRISM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-video-edit",
    "refVideoUrl": "https://cdn.example.com/source/product-demo.mp4",
    "prompt": "Replace the background with a bright product launch stage while preserving the subject motion",
    "generateAudio": false
  }'

Poll video job

curl -sS "$PRISM_BASE_URL/video/generations/$JOB_ID" \
  -H "Authorization: Bearer $PRISM_API_KEY"

หมายเหตุปฏิบัติการ

Video และ image model IDs ต้องอยู่ใน GET /v1/models ของ API key ที่เรียก
ตอนนี้ media input รองรับเฉพาะ URL request body ไม่รับ file upload ให้ host ไฟล์ไว้บน HTTPS URL ที่ runtime เข้าถึงได้ และควรใช้ short-lived URL หากทำได้
ถ้า model เป็น draft, มองไม่เห็น, ไม่ได้ตั้ง modality ที่เรียก, หรือ provider credentials ยังไม่ครบ Facade จะคืน catalog/runtime configuration error

ดูวิธีจัดการ failure ที่ Errors และข้อจำกัด trial ที่ Billing และ trials

เริ่มต้น

Core API

องค์กร

API reference

ตัวอย่างรูปภาพและวิดีโอ

ตัวอย่างรูปภาพและวิดีโอ

สร้างรูปภาพ

Text-to-video

Image-to-video

HappyHorse 1.1 text-to-video

HappyHorse reference-to-video

Video edit

Poll video job

หมายเหตุปฏิบัติการ

​ตัวอย่างรูปภาพและวิดีโอ

​สร้างรูปภาพ

​Text-to-video

​Image-to-video

​HappyHorse 1.1 text-to-video

​HappyHorse reference-to-video

​Video edit

​Poll video job

​หมายเหตุปฏิบัติการ

ตัวอย่างรูปภาพและวิดีโอ

สร้างรูปภาพ

Text-to-video

Image-to-video

HappyHorse 1.1 text-to-video

HappyHorse reference-to-video

Video edit

Poll video job

หมายเหตุปฏิบัติการ