ShareAI Platform Docs

Générer des vidéos

La soumission renvoie HTTP 202 avec un ID de tâche ShareAI et une URL de sondage.

Voir en Markdown
Sur cette page
POST https://api.shareai.now/api/v1/videos

Générer des vidéos

URL de base
https://api.shareai.now
Authentification
Clé API Bearer ou jeton d'accès OAuth approuvé
Portée requise
inference or monetization_gateway

La soumission renvoie HTTP 202 avec un ID de tâche ShareAI et une URL de sondage. Envoyez un Idempotency-Key en-tête stable pour les nouvelles tentatives de la même requête. La réutilisation de cette clé avec une entrée différente est rejetée. Sondez GET /api/v1/videos/{id} avec les mêmes identifiants d'origine. Les états incluent en file d'attente, en attente, en cours, finalisation, terminé, échoué et nécessite_une_revue. Un résultat nécessite_une_revue demande une réconciliation par l'équipe ; le sondage ne démarre jamais une autre génération.

Avant de commencer#

Configurez SHAREAI_API_KEY sur votre serveur et remplacez l'espace réservé du modèle par un modèle actuellement activé. Ne jamais exposer la clé API dans le code du navigateur. Le modèle, le compte, les identifiants et le fournisseur doivent tous autoriser cette opération. Les paramètres optionnels ci-dessous nécessitent la prise en charge du modèle ; les limites de sécurité de l'API ne garantissent pas que chaque modèle prend en charge chaque valeur.

Envoyez une requête#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  --data '{
  "model": "YOUR_ENABLED_VIDEOS_MODEL",
  "prompt": "A slow camera move through a quiet forest.",
  "duration": 8
}'

Champs de la requête#

ChampTypeSignification et limites
model requischaîneIdentifiant exact du modèle public activé. Doit déclarer cette opération et être autorisé par vos identifiants.
prompt requischaîneInvite de génération non vide, au maximum 256 KiB de texte UTF-8.
durationentierDurée vidéo demandée en option, en secondes, de 1 à 600, restreinte davantage par le modèle sélectionné. Les durées réellement retournées déterminent la facturation de la durée.
resolutionchaîneSélecteur de résolution pris en charge par le modèle, au maximum 100 caractères ; doit correspondre à la variante tarifaire publiée.
aspect_ratiochaîneSélecteur de ratio d'aspect pris en charge par le modèle, au maximum 100 caractères.
sizechaîneTaille de sortie prise en charge par le modèle, au maximum 100 caractères, par exemple 1024×1024. Tous les modèles ne prennent pas en charge cette option.
generate_audiobooléenSélecteur de bande sonore vidéo en option. La prise en charge par le modèle et la variante tarifaire correspondante sont requises.
seedentierGraine optionnelle prise en charge par le modèle. La vidéo nécessite un entier non négatif ; la reproductibilité dépend de l'exécuteur.
frame_imagestableauAu maximum deux parties image_url, chacune avec frame_type first_frame ou last_frame, sans doublons. Ne combinez pas frame_images et input_references.
input_referencestableauAu maximum 16 parties image_url typées avec image_url.url défini sur une URL HTTPS ou une URL de données d'image prise en charge. La prise en charge du modèle est requise.
providerobjetPréférences d'acheminement des fournisseurs facultatives. Utilisez provider.only pour les balises de fournisseurs acceptées, pas un préfixe dans l'ID du modèle. Les restrictions de compte et d'identifiants s'appliquent toujours.
allow_temporary_retentionbooléenVidéo uniquement. La valeur true explicite permet une rétention temporaire des résultats en amont sur les routes qui l'exigent. Omission/false rend ces routes indisponibles. Conflit avec provider.zdr:true ; les autres opérations conservent un ZDR obligatoire.

Lire le résultat#

Succès renvoie HTTP 202 avec JSON. La soumission renvoie HTTP 202 avec un ID de tâche ShareAI et une URL de sondage. Envoyez un Idempotency-Key en-tête stable pour les nouvelles tentatives de la même requête. La réutilisation de cette clé avec une entrée différente est rejetée. Sondez GET /api/v1/videos/{id} avec les mêmes identifiants d'origine. Les états incluent en file d'attente, en attente, en cours, finalisation, terminé, échoué et nécessite_une_revue. Un résultat nécessite_une_revue demande une réconciliation par l'équipe ; le sondage ne démarre jamais une autre génération.

Unités de facturation#

Les routes vidéo déclarent leurs unités facturées. Une route par seconde est réglée en fonction de la durée mesurée de chaque fichier retourné, jamais en fonction de la durée demandée ou du coût USD en amont. La durée demandée doit être comprise entre 1 et 600 secondes et prise en charge par le modèle. Une retenue de crédit prudente peut couvrir jusqu'à quatre sorties.

Choisissez l'identifiant exact du modèle activé depuis la Console. Son opération déclarée et ses capacités d'entrée/sortie doivent correspondre à ce point de terminaison ; un modèle de chat texte ne peut pas être substitué pour une autre opération. Vos restrictions d'identifiants, de fournisseur et de compte s'appliquent toujours.

Tarification et utilisation#

Les tarifs sont publiés en crédits IA EUR pour le modèle, le fournisseur, les unités et les variantes sélectionnés. Seules les dimensions de son tarif actif sont facturées. Une estimation réserve des crédits avant l'exécution ; les frais finaux sont basés sur l'utilisation mesurée. Les prix peuvent dépendre de la résolution, du format de sortie ou d'une tranche d'utilisation. Consultez l'onglet Utilisation dans la Console pour vérifier le débit final de ShareAI. Les champs de coûts en amont et les octets multimédias ne sont pas convertis en nombres de jetons inventés.

Accès et erreurs#

Utiliser inference pour une inférence approuvée avec coût réseau ou monetization_gateway pour une majoration approuvée par le Builder et des conditions de facturation acceptées. Un accès basé uniquement sur l'identité n'autorise pas les dépenses. La validation, l'autorisation du modèle, les crédits insuffisants, les limites de taux et les échecs d'exécution renvoient une structure error. Après un délai d'attente ou une soumission incertaine, vérifiez l'onglet Utilisation ou le travail vidéo avant de créer une autre demande potentiellement payante.

Rétention temporaire des vidéos#

Certaines routes vidéo nécessitent une rétention temporaire en amont pour que le résultat généré puisse être récupéré. Elles nécessitent votre allow_temporary_retention:true acceptation explicite pour cette demande vidéo. L'omission de cette acceptation rend ces routes indisponibles. Cette exception s'applique uniquement aux vidéos et ne permet jamais l'entraînement de modèles ou la rétention pour d'autres opérations. Une politique ZDR explicite ne peut pas être affaiblie de manière implicite.

JSON

{"allow_temporary_retention": true}

Vérifier l'état de la tâche#

GET https://api.shareai.now/api/v1/videos/{id}

Lire une génération vidéo avec ses identifiants d'origine

URL de base
https://api.shareai.now
Authentification
Clé API Bearer ou jeton d'accès OAuth approuvé
Portée requise
inference or monetization_gateway

JSON

{
  "id": "YOUR_JOB_ID",
  "object": "video",
  "status": "pending",
  "created_at": 1793664000,
  "polling_url": "/api/v1/videos/YOUR_JOB_ID"
}

Le JSON ci-dessus illustre les champs stables de la tâche, pas une génération réelle. Sondez le chemin ShareAI avec la même clé, en attendant entre les vérifications. en file d'attente, en attente, en cours et finalisation signifient attendre ; terminé expose les données avec des URL de contenu ShareAI ; échoué et nécessite_une_revue signifient arrêter et inspecter. Relisez l'état après des erreurs transitoires, mais ne soumettez pas automatiquement une nouvelle génération. Un identifiant différent ou révoqué ne peut pas récupérer la tâche.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
  -H "Authorization: Bearer $SHAREAI_API_KEY"

Télécharger le résultat#

Une fois terminé, chaque entrée de données contient une URL de contenu ShareAI. Récupérez-la GET /api/v1/videos/{id}/content?index=0 en utilisant les mêmes identifiants d'origine. Le point de terminaison prend en charge une seule plage d'octets HTTP. Les URL des fournisseurs, les tickets privés et les identifiants des fournisseurs ne sont jamais retournés. Le sondage et le téléchargement ne créent pas une deuxième requête d'inférence ou de frais d'ingestion du Monetization Gateway. Une tâche terminée signifie que le règlement est confirmé avant que le fichier ne devienne téléchargeable.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4

Les frame_images facultatives doivent contenir des parties image_url avec first_frame ou last_frame. Utilisez des images de cadre ou des images de référence dans une seule requête, pas les deux. Les durées, résolutions et rapports d'aspect des modèles peuvent être plus restrictifs que les limites de sécurité de l'API. Les webhooks et les URLs de rappel arbitraires ne sont pas pris en charge.

Dernière mise à jour le 3 novembre 2026

Documentation de la plateforme ShareAI
Toute la documentation

Rechercher par titre ou contenu.

Poser une question sur cette page

Choisissez un assistant pour explorer cette page. Vous pouvez également copier la page et la coller dans votre conversation.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI