Documentation

Vidéos

POST /v1/videos est l’endpoint compatible OpenAI Video pour les providers qui exposent une route vidéo native.

À utiliser quand

  • Ton provider upstream expose un endpoint vidéo au format OpenAI.
  • Tu veux générer des vidéos depuis un prompt texte avec la même clé Prismatic que les endpoints texte et image.
  • Le modèle sélectionné et sa route provider supportent tous les deux les vidéos.

Exemples de code

curl
curl https://api.prismaticapi.com/v1/videos   -H "Authorization: Bearer $PRISMATIC_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "veo-3-1",
    "prompt": "A serene koi pond at sunset, cinematic",
    "size": "1080x1920",
    "duration": 8,
    "n": 1
  }'

Paramètres

  • model (string, requis) — ID public retourné par GET /v1/models.
  • prompt (string, requis) — Prompt texte décrivant la vidéo à générer.
  • size, duration, n et les autres champs supportés par le provider sont transmis à l’endpoint vidéo upstream.

Billing et limites

  • Les limites API key et compte sont vérifiées avant la génération.
  • Le quota subscription est réservé avant génération puis réglé après.
  • Le coût PAYG vidéo vaut retail_generation_usd * n dans cette phase, pas par seconde et pas selon l’usage token.
  • Si le modèle ou la route provider ne supporte pas les vidéos, la requête échoue avant tout appel upstream.

Notes

  • L’endpoint transmet les requêtes vers /v1/videos sur le provider upstream sélectionné.
  • Active le toggle Vidéos sur un provider dans l’admin pour qu’il puisse recevoir du trafic de génération vidéo.
  • L’endpoint réécrit le modèle vers l’ID upstream avant le proxy.