Modèles - Runbase Docs

Runbase donne accès aux meilleurs modèles de génération d’images et de vidéos de plusieurs fournisseurs via une seule API.

Parcourir les modèles

Visitez la page des modèles pour voir tous les modèles disponibles avec leurs tarifs, leurs capacités et des exemples de résultats. Chaque modèle dispose d’une page de विवरण dédiée avec :

Playground — testez le modèle dans votre navigateur avant d’écrire du code
Tarification — coût par exécution ou par seconde
Exemples — exemples de résultats avec des prompts
Référence API — paramètres d’entrée spécifiques au modèle et exemples de code

Playground

Chaque page de modèle inclut un Playground interactif en haut. Connectez-vous, saisissez un prompt et cliquez sur Run model pour voir le résultat en quelques secondes. C’est le moyen le plus rapide d’évaluer la qualité et la rapidité d’un modèle avant de l’intégrer à votre application.

Format de l’ID du modèle

Chaque modèle a un ID au format provider/model-name, par exemple :

openai/gpt-image-2 — génération d’images
bytedance/seedance-2 — génération de vidéos
google/veo-3 — génération de vidéos

La liste complète des modèles disponibles et de leurs IDs se trouve sur la page des modèles. De nouveaux modèles sont ajoutés régulièrement — consultez-la pour voir les derniers.

Paramètres d’entrée

Chaque modèle définit son propre schéma d’entrée. Les paramètres courants incluent :

prompt (string) — description textuelle de ce qu’il faut générer
aspect_ratio (string) — dimensions de sortie, par ex. "1:1", "16:9"
quality (string) — niveau de qualité de génération
image_urls (string[]) — URLs d’images de référence (là où c’est pris en charge)

Consultez la page de détails de chaque modèle pour le schéma d’entrée complet et les options disponibles.

Utiliser un modèle

Passez l’ID du modèle et l’objet d’entrée au endpoint create run :

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-5-lite",
    "input": {
      "prompt": "A mountain landscape at sunset, oil painting"
    }
  }'

Si vous passez un ID de modèle invalide, vous obtiendrez une erreur 400 model_not_found. Si l’entrée ne correspond pas au schéma du modèle, vous obtiendrez 400 invalid_input avec une description du problème.

Modèles d’images vs. de vidéos

Les modèles d’images renvoient une ou plusieurs URLs d’images dans output.urls. Le temps de génération varie selon le modèle, la charge du fournisseur et la complexité de l’entrée.
Les modèles de vidéos renvoient une URL de vidéo dans output.urls. Le temps de génération varie selon le modèle, la durée, la résolution et la charge du fournisseur.

La forme de l’API est identique pour les deux — la seule différence est la cible des URLs de sortie.