GetRouterDocs
  • Français

    • Images

    GetRouter expose des endpoints distincts pour la génération et la modification d’images.

    POST https://getrouter.ai/v1/images/generations
POST https://getrouter.ai/v1/images/edits

    Choisissez un modèle d’image dans Modèles, puis vérifiez son tarif et les options prises en charge avant d’envoyer une requête.

    Générer une image

    curl https://getrouter.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "A minimal black-and-white illustration of an API router",
    "n": 1,
    "size": "1024x1024",
    "response_format": "url"
  }'

    La réponse contient un tableau data. Selon la requête et le modèle, chaque élément peut contenir une URL hébergée ou des données d’image encodées en Base64.

    Python

    from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://getrouter.ai/v1",
)

response = client.images.generate(
    model="MODEL_ID",
    prompt="A minimal black-and-white illustration of an API router",
    size="1024x1024",
    n=1,
)

print(response.data[0].url or response.data[0].b64_json)

    Modifier une image

    La modification d’image utilise des données de formulaire multipart :

    curl https://getrouter.ai/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=Replace the background with a clean studio wall" \
  -F "[email protected]" \
  -F "n=1"

    Un modèle compatible peut également accepter un masque et des champs supplémentaires propres au modèle.

    Champs courants

    ChampUtilité
    modelID du modèle d’image
    promptDescription ou instruction de modification
    nNombre d’images demandées
    sizeDimensions de sortie prises en charge par le modèle
    qualityMode de qualité propre au modèle
    styleMode de style propre au modèle
    response_formatLes valeurs courantes comprennent url et b64_json

    L’API prend également en charge des charges utiles d’image propres à certains fournisseurs pour certains modèles. Lorsqu’un modèle nécessite une structure de corps différente, utilisez le schéma et l’exemple présentés dans la référence de l’API.

    Warning

    Le nombre d’images, les dimensions, la qualité et la prise en charge de la modification varient selon le modèle et ont une incidence directe sur le coût. Consultez les tarifs avant de lancer une génération par lots.

    Gérer la sortie en toute sécurité

    • Téléchargez le contenu des URL hébergées avant leur expiration.
    • Décodez b64_json avant de l’écrire dans un fichier.
    • Validez le type MIME de la sortie dans les applications qui servent les fichiers générés.
    • Évitez de relancer une génération réussie au seul motif que le client n’a pas pu enregistrer la réponse.

    Étapes suivantes