OneMux/Documentation/Modèles d’images

Modèles d’images

Générez et modifiez des images à l’aide de l’API des modèles d’images OneMux.

Présentation de l’API

Les modèles d’images utilisent une API Images dédiée. N’envoyez pas de requêtes de génération d’images à /v1/chat/completions.

  • Génération d’images : POST https://api.onemux.net/v1/images/generations
  • Modification d’images : POST https://api.onemux.net/v1/images/edits
  • Authentification : Authorization: Bearer YOUR_API_KEY
  • Modèle : utilisez l’ID réel du modèle d’image renvoyé par l’API de la liste des modèles actuelle

Commencez par récupérer les modèles actuellement disponibles :

curl https://api.onemux.net/v1/models \
  -H "Authorization: Bearer $ONEMUX_API_KEY"

La prise en charge de la génération, de la modification, des images de référence, des dimensions, de la qualité, du format de sortie et des autres paramètres dépend de la liste des modèles et des capacités réelles du fournisseur en amont.

Génération d’images

Utilisez /v1/images/generations pour envoyer une requête de génération d’image à partir d’un texte.

curl https://api.onemux.net/v1/images/generations \
  -H "Authorization: Bearer $ONEMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_IMAGE_MODEL_ID",
    "prompt": "一只坐在窗边的橘猫,午后自然光,写实摄影风格",
    "size": "1024x1024",
    "quality": "medium"
  }'

Paramètres courants :

ParamètreObligatoireDescription
modelOuiID d’un modèle d’image actuellement disponible
promptOuiDescription du contenu de l’image
sizeNonDimensions de l’image ; la plage prise en charge dépend du modèle
qualityNonQualité de l’image ; les valeurs prises en charge dépendent du modèle
nNonNombre d’images à générer ; la plage prise en charge dépend du modèle
response_formatNonb64_json ou url ; seuls les modèles compatibles peuvent l’utiliser
backgroundNonArrière-plan transparent ou opaque ; seuls les modèles compatibles peuvent l’utiliser
output_formatNonpng, jpeg, webp ; seuls les modèles compatibles peuvent l’utiliser

N’utilisez pas directement les paramètres pris en charge par un modèle avec d’autres modèles d’images. Si vous obtenez une erreur model_not_found, invalid_model ou indiquant qu’un paramètre n’est pas pris en charge, vérifiez d’abord l’ID du modèle et ses capacités.

Modification d’images

Utilisez /v1/images/edits pour modifier une image existante. Les modèles d’images compatibles avec OpenAI utilisent couramment multipart/form-data pour téléverser une image :

curl https://api.onemux.net/v1/images/edits \
  -H "Authorization: Bearer $ONEMUX_API_KEY" \
  -F "model=YOUR_IMAGE_MODEL_ID" \
  -F "image[]=@input.png" \
  -F "prompt=将背景改为浅蓝色,保持主体和文字不变" \
  -F "size=1024x1024"

Vous pouvez transmettre plusieurs images de référence en répétant image[], par exemple :

-F "image[]=@person.png" \
-F "image[]=@product.png"

Le nombre et le format des images, les masques, les URL des images de référence et le format JSON de modification dépendent du modèle et du fournisseur en amont. N’utilisez ces paramètres que si le modèle les prend explicitement en charge.

Utilisation avec Python

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["ONEMUX_API_KEY"],
    base_url="https://api.onemux.net/v1",
)

result = client.images.generate(
    model="YOUR_IMAGE_MODEL_ID",
    prompt="一张简洁的蓝色科技风产品海报",
    size="1024x1024",
)

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

La modification d’images nécessite généralement l’envoi direct de fichiers au format multipart. Si la version actuelle du SDK Python ne prend pas en charge les paramètres de modification du modèle visé, utilisez la requête cURL ci-dessus.

Résultat renvoyé

Une réponse réussie contient généralement un tableau data :

{
  "created": 1760000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgo..."
    }
  ]
}

Certains modèles renvoient une URL d’image lorsque la requête spécifie response_format comme url :

{
  "created": 1760000000,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

Si vous recevez du Base64, enregistrez le fichier selon le format réel de l’image. Si vous recevez une URL, téléchargez l’image rapidement et enregistrez-la vous-même afin d’éviter l’expiration de l’adresse temporaire.

Facturation

La facturation des modèles d’images n’est pas toujours calculée en Tokens. OneMux applique les règles de facturation actuellement publiées pour chaque modèle. Elles peuvent notamment inclure :

  • Une facturation par image générée
  • Une facturation selon la résolution de l’image ou le niveau de qualité
  • Une facturation selon les Tokens d’entrée ou de sortie de l’image, ou selon d’autres unités d’utilisation du fournisseur en amont

Pour connaître les prix, les unités de facturation et les spécifications prises en charge, consultez la description actuelle du modèle correspondant dans le catalogue des modèles. Une requête échouée n’entraîne généralement pas les frais d’image associés à un résultat réussi, mais le comportement exact dépend des informations affichées sur la page et de la réponse du serveur.

Questions fréquentes

Pourquoi ne puis-je pas utiliser l’API de conversation pour générer des images ?

Les modèles d’images utilisent une route Images dédiée. L’envoi d’une requête à /v1/chat/completions ou à une autre API inadaptée peut renvoyer une erreur indiquant que le modèle ne prend pas en charge ce point de terminaison ou que les paramètres sont incorrects.

Pourquoi la requête échoue-t-elle alors que le nom du modèle est disponible ?

Vérifiez que le modèle autorise la génération ou la modification d’images, que votre clé API actuelle dispose des autorisations nécessaires, que les paramètres de la requête sont pris en charge par ce modèle et que le fournisseur en amont correspondant est disponible.

Pourquoi la réponse contient-elle du Base64 plutôt qu’un lien vers l’image ?

Le format renvoyé dépend du modèle et du paramètre response_format. Si vous recevez b64_json, vous devez décoder les données et enregistrer l’image côté client. Si vous recevez url, vous devez télécharger l’image depuis l’adresse renvoyée.

Que faire si la génération d’images est lente ?

Les requêtes portant sur des images haute résolution ou de haute qualité, ou impliquant des modifications complexes, peuvent prendre plus de temps. Le client doit définir un délai d’expiration raisonnable et éviter de renvoyer la même requête après un dépassement de délai, afin de ne pas créer de tâches ou de frais en double.

GPT Image 2.6 : SVG, GIF et complexité

La série GPT Image 2.6 ajoute la sortie SVG, la sortie d’animations GIF et le paramètre complexity. Ces fonctionnalités ne sont disponibles qu’avec les modèles et les fournisseurs en amont qui les prennent en charge.

Sortie SVG

Le SVG est utilisé pour la génération d’images, pas pour leur modification. Lors d’un appel à l’API de génération, définissez output_format sur svg et n sur 1. Les données de l’image dans la réponse sont encodées en Base64. Décodez-les puis enregistrez-les dans un fichier .svg.

{
  "model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
  "prompt": "一个简洁的蓝色几何图形标志",
  "output_format": "svg",
  "n": 1
}

Certaines configurations de fournisseurs en amont peuvent également exiger un objet svg supplémentaire, par exemple svg.model. Ajoutez-le uniquement si la documentation du modèle ou du fournisseur l’exige explicitement. Les images SVG ne sont pas prises en charge par tous les modèles d’images ni par tous les fournisseurs.

Sortie d’animations GIF

Les modèles GPT Image 2.6 compatibles peuvent définir output_format sur gif dans l’API de génération d’images. Lorsque le modèle le permet, utilisez frame_count et frame_duration_ms pour définir le nombre d’images d’animation et la durée de chaque image. Le GIF est une fonctionnalité de génération ; ne supposez pas que l’API de modification d’images peut également renvoyer un GIF.

{
  "model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
  "prompt": "一只蓝色小鸟循环拍打翅膀的动画",
  "output_format": "gif",
  "frame_count": 6,
  "frame_duration_ms": 200
}

Paramètre de complexité

La série GPT Image 2.6 prend en charge complexity : low, medium, high. Pour des retouches simples, essayez une complexité plus faible. Pour des images riches en texte ou à la mise en page complexe, essayez une complexité plus élevée. Ce paramètre est distinct de quality ; une complexité plus élevée peut ralentir la génération.

{
  "model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
  "prompt": "一张细节丰富的城市街景编辑插画",
  "complexity": "high",
  "quality": "high"
}

Ces paramètres ne sont pas universels. Si l’API indique qu’un paramètre n’est pas pris en charge, supprimez les paramètres facultatifs ou vérifiez les capacités du modèle et du fournisseur sélectionnés.