API
GPT Image
API Overview
OpenAI’s gpt-image-1
image generation API offers both text-to-image generation and image-to-image editing with text guidance capabilities.
Before using this API, please ensure you have the latest OpenAI package installed by running pip install -U openai
.
Important Notes
- Once an API call is sent, you will be charged regardless of any interruptions or failures during the generation process
- Names of living artists (such as “Hayao Miyazaki”, “Makoto Shinkai”, etc.) will trigger a
moderation_blocked
error, causing generation to fail. You can work around this by using non-sensitive terms like “Ghibli” or “bright modern Japanese anime style” instead. The same applies to images with revealing clothing or suggestive content. - Generally, referencing “styles” is safer than naming “artists” - for example, “Pixar” is supported.
- A more reliable approach is to use deceased artists or their corresponding styles, such as “Van Gogh” or “Mona Lisa”
Model and Pricing
Model | Quality | 1024x1024 | 1024x1536 | 1536x1024 |
---|---|---|---|---|
gpt-image-1 | low | $0.011 | $0.016 | $0.016 |
gpt-image-1 | medium | $0.042 | $0.063 | $0.063 |
gpt-image-1 | high | $0.167 | $0.25 | $0.25 |
Note: The input text tokens are billed separately at $5 per million tokens.
API Usage
Endpoints
- Image generation:
https://aihubmix.com/v1/images/generations
- Image editing:
https://aihubmix.com/v1/images/edits
Python Examples:
For more parameter details, please refer to the OpenAI official documentation
Output Examples
Rejection Scenarios
Error message when a request is rejected:
Practical Tips
- Supports all languages. Chinese text works reliably, though we don’t recommend generating large amounts of text in any language
- The size parameter doesn’t support explicitly passing size=“auto” - auto is the default
- Aspect ratios can be specified in the prompt (supports 2:3, 3:2, 1:1) or set via the size parameter
- The
moderation
parameter controls sensitivity, but even with it set to “low,” requests might still be rejected (e.g., if Venus is too revealing) - The edits endpoint doesn’t support the
moderation
parameter - Combining text descriptions with reference images produces more accurate results
- Compressing uploaded images as pre-processing can improve speed
- Transparent backgrounds are supported (no need for manual cutouts) — just add this requirement to your prompt