Image à image (édition d’image)

curl 'https://www.bettertoken.ai/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'model=YOUR_MODEL_ID' \
  -F 'prompt=参考这张图片，生成一张更精致的方形产品主视觉，保持主体风格一致。' \
  -F 'n=1' \
  -F 'size=1024x1024' \
  -F 'response_format=b64_json' \
  -F 'output_format=png' \
  -F 'image=@reference.png'

{
  "created": 1710000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...(truncated)"
    }
  ]
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

POST

images

edits

curl 'https://www.bettertoken.ai/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'model=YOUR_MODEL_ID' \
  -F 'prompt=参考这张图片，生成一张更精致的方形产品主视觉，保持主体风格一致。' \
  -F 'n=1' \
  -F 'size=1024x1024' \
  -F 'response_format=b64_json' \
  -F 'output_format=png' \
  -F 'image=@reference.png'

{
  "created": 1710000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...(truncated)"
    }
  ]
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

POST /v1/images/edits L’endpoint image à image utilise un corps de Request multipart/form-data. Téléversez une ou plusieurs images de référence et envoyez les champs de prompt et de paramètres sous forme de champs de formulaire.

Utilisez https://www.bettertoken.ai/v1 comme Base URL. Passez votre BetterToken API Key via Authorization: Bearer YOUR_API_KEY.

Vous pouvez renseigner les champs de formulaire et téléverser des images de référence dans le Playground à droite de la page, puis envoyer la Request directement à https://www.bettertoken.ai/v1/images/edits.

N’utilisez pas de corps JSON ordinaire pour les Request image à image. Envoyez les champs texte et fichier avec multipart/form-data.

Valeurs recommandées

Envoyez explicitement ces champs dans chaque Request :

model=gpt-image-2
n=1
response_format=b64_json
output_format=png

Utilisez image pour une seule image de référence. Utilisez des champs image[] répétés pour plusieurs images de référence.

Une image de référence

curl 'https://www.bettertoken.ai/v1/images/edits' \
  -H 'Authorization: Bearer sk-***REDACTED***' \
  -F 'model=gpt-image-2' \
  -F 'prompt=Use this reference image to create a more polished square product hero image while keeping the main style consistent.' \
  -F 'n=1' \
  -F 'size=1024x1024' \
  -F 'response_format=b64_json' \
  -F 'output_format=png' \
  -F 'image=@reference.png'

Plusieurs images de référence

curl 'https://www.bettertoken.ai/v1/images/edits' \
  -H 'Authorization: Bearer sk-***REDACTED***' \
  -F 'model=gpt-image-2' \
  -F 'prompt=Combine these reference images into one consistent promotional poster.' \
  -F 'n=1' \
  -F 'size=1024x1024' \
  -F 'response_format=b64_json' \
  -F 'output_format=png' \
  -F 'image[]=@reference-1.png' \
  -F 'image[]=@reference-2.jpg' \
  -F 'image[]=@reference-3.png'

Exemple Python

import requests

url = "https://www.bettertoken.ai/v1/images/edits"
headers = {
    "Authorization": "Bearer sk-***REDACTED***",
}

data = {
    "model": "gpt-image-2",
    "prompt": "Use this reference image to create a more polished square product hero image while keeping the main style consistent.",
    "n": "1",
    "size": "1024x1024",
    "response_format": "b64_json",
    "output_format": "png",
}

with open("reference.png", "rb") as image_file:
    files = {
        "image": ("reference.png", image_file, "image/png"),
    }
    response = requests.post(url, headers=headers, data=data, files=files, timeout=300)

response.raise_for_status()
result = response.json()
b64_json = result["data"][0]["b64_json"]

Tailles recommandées

`size`	Ratio	Cas d’utilisation
`auto`	Auto	Sélection automatique de la taille
`1024x1024`	`1:1`	Images carrées, avatars, couvertures, ressources
`1536x1024`	`3:2`	Affiches, bannières et scènes au format paysage
`1024x1536`	`2:3`	Couvertures et affiches mobiles au format portrait
`1536x1152`	`4:3`	Images paysage standard, images de produit, illustrations de contenu
`1152x1536`	`3:4`	Images portrait standard, couvertures mobiles, affiches verticales
`2048x2048`	`1:1`	Images carrées haute résolution
`2048x1152`	`16:9`	Images paysage haute résolution
`3840x2160`	`16:9`	Images paysage 4K
`2160x3840`	`9:16`	Images portrait 4K

size représente le ratio attendu et le niveau de taille. Les pixels réellement renvoyés peuvent être mappés ou ajustés par le serveur. Utilisez les dimensions de l’image décodée plutôt que de recadrer de force la sortie à la valeur demandée.

Enregistrer l’image

Une réponse réussie suit la structure de réponse d’image OpenAI compatible :

{
  "created": 1710000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...(truncated)"
    }
  ]
}

Lisez data[0].b64_json et enregistrez-le comme contenu d’image base64. Définissez toujours output_format: "png" afin de pouvoir enregistrer l’image décodée sous .png.

Flux de réponse

Cet endpoint est synchrone. Après l’envoi de POST /images/edits, gardez la Request HTTP actuelle ouverte jusqu’à la réponse du serveur. Lorsque la génération réussit, le contenu de l’image est renvoyé dans data[0].b64_json. L’endpoint ne renvoie pas de task_id, et il n’existe pas d’endpoint distinct de requête de statut ou de téléchargement de résultat.

Documents associés

Autorisations

Authorization

string

header

requis

Use your BetterToken API Key as a bearer token. Do not expose API keys in frontend browser code, screenshots, logs, tickets, or Git repositories.

Corps

multipart/form-data

model

enum<string>

défaut:YOUR_MODEL_ID

requis

固定使用 YOUR_MODEL_ID。

Options disponibles:

YOUR_MODEL_ID

Exemple:

"YOUR_MODEL_ID"

prompt

string

requis

图片编辑或参考图生成说明。

Exemple:

"参考这张图片，生成一张更精致的方形产品主视觉，保持主体风格一致。"

image

file

单张参考图字段名。单参考图时使用 image。

image[]

file[]

多张参考图字段名。多参考图时重复提交 image[]。

défaut:1

推荐固定为 1。多张图片建议发起多次独立请求。

Exemple:

"1"

size

enum<string>

défaut:1024x1024

图片尺寸和比例档位。auto 为自动；1024x1024 和 2048x2048 为 1:1；1536x1024 为 3:2；1024x1536 为 2:3；1536x1152 为 4:3；1152x1536 为 3:4；2048x1152 和 3840x2160 为 16:9；2160x3840 为 9:16。实际返回像素可能由服务端映射或调整，客户端应以解码后的真实图片尺寸为准。

Options disponibles:

auto,

1024x1024,

1536x1024,

1024x1536,

1536x1152,

1152x1536,

2048x2048,

2048x1152,

3840x2160,

2160x3840

Exemple:

"1024x1024"

response_format

enum<string>

défaut:b64_json

推荐固定为 b64_json。

Options disponibles:

b64_json

Exemple:

"b64_json"

output_format

enum<string>

défaut:png

推荐固定为 png。不要依赖 jpeg 或 webp 直接返回对应格式。

Options disponibles:

png

Exemple:

"png"

Réponse

Image generation result.

OpenAI-compatible image response. Clients should read data[0].b64_json and allow additional fields such as revised_prompt.

created

integer

Exemple:

1710000000

data

object[]

Show child attributes

​Valeurs recommandées

​Une image de référence

​Plusieurs images de référence

​Exemple Python

​Tailles recommandées

​Enregistrer l’image

​Flux de réponse

​Documents associés

Autorisations

Corps

Réponse

Valeurs recommandées

Une image de référence

Plusieurs images de référence

Exemple Python

Tailles recommandées

Enregistrer l’image

Flux de réponse

Documents associés