Generate high-quality images, posters, and logos with Ideogram latest V4.0 — producing crisp visuals with accurate text rendering, fine detail, and full creative control for polished, ready-to-use designs.
Join the Discord community for the latest model updates, prompts, and support.
La tua richiesta costerà $0.025 per esecuzione. Con $10 puoi eseguire questo modello circa 400 volte.
Ecco cosa puoi fare dopo:
import requests
import time
# Step 1: Start image generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "ideogram/v4/quality/text-to-image", # Required. model name
"prompt": "A beautiful landscape with mountains and lake", # Required. Text description of the image to generate
"image_size": "landscape_16_9", # Output image size preset. options: square_hd | square | portrait_3_4 | portrait_9_16 | landscape_4_3 | landscape_16_9
"output_format": "jpeg", # File format of the generated image. options: jpeg | png
"seed": 0, # Random seed for reproducibility. (min: 0)
}
generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]
# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
def check_status():
while True:
response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
result = response.json()
if result["data"]["status"] == "completed":
print("Generated image:", result["data"]["outputs"][0])
return result["data"]["outputs"][0]
elif result["data"]["status"] == "failed":
raise Exception(result["data"]["error"] or "Generation failed")
else:
# Still processing, wait 2 seconds
time.sleep(2)
image_url = check_status()Installa il pacchetto di dipendenze richiesto.
pip install requestsTutte le richieste API richiedono l'autenticazione tramite una chiave API. Puoi ottenere la tua chiave API dalla dashboard di Atlas Cloud.
export ATLASCLOUD_API_KEY="your-api-key-here"import os
API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {API_KEY}"
}Non esporre mai la tua chiave API nel codice lato client o nei repository pubblici. Utilizza invece variabili d'ambiente o un proxy backend.
import requests
url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "your-model",
"prompt": "A beautiful landscape"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())Invia una richiesta di generazione asincrona. L'API restituisce un ID di previsione che puoi usare per controllare lo stato e recuperare il risultato.
/api/v1/model/generateImageimport requests
url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "ideogram/v4/quality/text-to-image",
"prompt": "A beautiful landscape with mountains and lake"
}
response = requests.post(url, headers=headers, json=data)
result = response.json()
print(f"Prediction ID: {result['data']['id']}")
print(f"Status: {result['data']['status']}"){
"code": 200,
"data": {
"id": "pred_abc123",
"status": "processing",
"model": "model-name",
"created_at": "2025-01-01T00:00:00Z"
}
}Interroga l'endpoint di previsione per verificare lo stato attuale della tua richiesta.
/api/v1/model/prediction/{prediction_id}import requests
import time
prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }
while True:
response = requests.get(url, headers=headers)
result = response.json()
status = result["data"]["status"]
print(f"Status: {status}")
if status in ["completed", "succeeded"]:
output_url = result["data"]["outputs"][0]
print(f"Output URL: {output_url}")
break
elif status == "failed":
print(f"Error: {result['data'].get('error', 'Unknown')}")
break
time.sleep(3)processingLa richiesta è ancora in fase di elaborazione.completedGenerazione completata. Gli output sono disponibili.succeededGenerazione riuscita. Gli output sono disponibili.failedLa generazione è fallita. Controlla il campo errore.{
"data": {
"id": "pred_abc123",
"status": "completed",
"outputs": [
"https://storage.atlascloud.ai/outputs/result.png"
],
"metrics": {
"predict_time": 8.3
},
"created_at": "2025-01-01T00:00:00Z",
"completed_at": "2025-01-01T00:00:10Z"
}
}Carica file nello storage Atlas Cloud e ottieni un URL utilizzabile nelle tue richieste API. Usa multipart/form-data per il caricamento.
/api/v1/model/uploadMediaimport requests
url = "https://api.atlascloud.ai/api/v1/model/uploadMedia"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }
with open("image.png", "rb") as f:
files = {"file": ("image.png", f, "image/png")}
response = requests.post(url, headers=headers, files=files)
result = response.json()
download_url = result["data"]["download_url"]
print(f"File URL: {download_url}"){
"data": {
"download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
"file_name": "image.png",
"content_type": "image/png",
"size": 1024000
}
}I seguenti parametri sono accettati nel corpo della richiesta.
{
"model": "ideogram/v4/quality/text-to-image",
"prompt": "A beautiful landscape",
"image_size": "landscape_16_9",
"output_format": "jpeg"
}L'API restituisce una risposta di previsione con gli URL degli output generati.
{
"id": "pred_abc123",
"status": "completed",
"model": "model-name",
"outputs": [
"https://storage.atlascloud.ai/outputs/result.png"
],
"metrics": {
"predict_time": 8.3
},
"created_at": "2025-01-01T00:00:00Z",
"completed_at": "2025-01-01T00:00:10Z"
}Atlas Cloud Skills integra oltre 400 modelli di IA direttamente nel tuo assistente di codifica IA. Un comando per installare, poi usa il linguaggio naturale per generare immagini, video e chattare con LLM.
npx skills add AtlasCloudAI/atlas-cloud-skillsOttieni la tua chiave API dalla dashboard di Atlas Cloud e impostala come variabile d'ambiente.
export ATLASCLOUD_API_KEY="your-api-key-here"Una volta installato, puoi usare il linguaggio naturale nel tuo assistente IA per accedere a tutti i modelli Atlas Cloud.
Il server MCP di Atlas Cloud collega il tuo IDE con oltre 400 modelli di IA tramite il Model Context Protocol. Funziona con qualsiasi client compatibile MCP.
npx -y atlascloud-mcpAggiungi la seguente configurazione al file delle impostazioni MCP del tuo IDE.
{
"mcpServers": {
"atlascloud": {
"command": "npx",
"args": [
"-y",
"atlascloud-mcp"
],
"env": {
"ATLASCLOUD_API_KEY": "your-api-key-here"
}
}
}
}{
"info": {
"description": "The AtlasCloud API.",
"title": "AtlasCloud API",
"version": "1.0.0"
},
"paths": {
"/api/v1/model/generateImage": {
"post": {
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PredictionResponse"
}
}
},
"description": "The request status."
}
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Input"
}
}
}
}
},
"x-api-name": "model_run"
},
"/api/v1/model/prediction/{request_id}": {
"get": {
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PredictionResponse"
}
}
},
"description": "Result of the request."
}
},
"parameters": [
{
"in": "path",
"name": "request_id",
"schema": {
"type": "string",
"description": "Request ID"
},
"required": true
}
]
},
"x-api-name": "model_result"
}
},
"openapi": "3.0.0",
"servers": [
{
"url": "https://api.atlascloud.ai"
}
],
"components": {
"schemas": {
"Input": {
"properties": {
"model": {
"type": "string",
"description": "model name",
"default": "ideogram/v4/quality/text-to-image"
},
"prompt": {
"description": "Text description of the image to generate. Maximum 2,000 characters.",
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"image_size": {
"description": "Output image size preset.",
"type": "string",
"x-atlas": {
"max_width": 3840,
"min_height": 512,
"min_width": 512,
"max_height": 3840,
"multiple_of": 16
},
"default": "landscape_16_9",
"enum": [
"square_hd",
"square",
"portrait_3_4",
"portrait_9_16",
"landscape_4_3",
"landscape_16_9"
],
"x-ui-component": "select",
"x-enum-labels": {
"square_hd": "Square HD (1024×1024)",
"square": "Square (512×512)",
"portrait_3_4": "Portrait 3:4",
"portrait_9_16": "Portrait 9:16",
"landscape_4_3": "Landscape 4:3",
"landscape_16_9": "Landscape 16:9"
}
},
"output_format": {
"description": "File format of the generated image.",
"type": "string",
"default": "jpeg",
"enum": [
"jpeg",
"png"
],
"x-ui-component": "select"
},
"seed": {
"description": "Random seed for reproducibility. Use the same seed and prompt to reproduce results.",
"type": "integer",
"minimum": 0
}
},
"required": [
"model",
"prompt"
],
"type": "object",
"x-order-properties": [
"model",
"prompt",
"image_size",
"output_format",
"seed"
]
},
"PredictionResponse": {
"properties": {
"model": {
"type": "string",
"description": "model name",
"default": "ideogram/v4/quality/text-to-image"
},
"created_at": {
"description": "ISO timestamp of when the request was created (e.g., \"2023-04-01T12:34:56.789Z\").",
"format": "date-time",
"type": "string"
},
"id": {
"description": "Unique identifier for the prediction.",
"type": "string"
},
"outputs": {
"description": "Array of URLs to the generated images. Null when status is not completed.",
"items": {
"type": "string"
},
"nullable": true,
"type": "array"
},
"status": {
"description": "Status of the task: created, processing, completed, or failed.",
"type": "string"
},
"urls": {
"description": "Object containing related API endpoints.",
"type": "object"
}
},
"type": "object"
}
},
"securitySchemes": {
"apiKeyAuth": {
"in": "header",
"name": "Authorization",
"type": "apiKey"
}
}
}
}# ideogram/v4/quality/text-to-image
> Generate high-quality images, posters, and logos with Ideogram latest V4.0 — producing crisp visuals with accurate text rendering, fine detail, and full creative control for polished, ready-to-use designs.
## Overview
- **Submit endpoint (POST)**: `https://api.atlascloud.ai/api/v1/model/generateImage` — start an async generation; returns a `prediction_id`
- **Poll endpoint (GET)**: `https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}` — poll this until the prediction finishes
- **Model ID**: `ideogram/v4/quality/text-to-image`
## API Information
This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.
### Input Schema
The API accepts the following input parameters:
- **`model`** (`string`, _required_):
model name
- Default: `"ideogram/v4/quality/text-to-image"`
- **`prompt`** (`string`, _required_):
Text description of the image to generate. Maximum 2,000 characters.
- **`image_size`** (`string`, _optional_):
Output image size preset.
- Default: `"landscape_16_9"`
- Options: "square_hd", "square", "portrait_3_4", "portrait_9_16", "landscape_4_3", "landscape_16_9"
- **`output_format`** (`string`, _optional_):
File format of the generated image.
- Default: `"jpeg"`
- Options: "jpeg", "png"
- **`seed`** (`integer`, _optional_):
Random seed for reproducibility. Use the same seed and prompt to reproduce results.
- Min: 0
**Required Parameters Example**:
```json
{
"model": "ideogram/v4/quality/text-to-image",
"prompt": ""
}
```
**Full Example**:
```json
{
"model": "ideogram/v4/quality/text-to-image",
"prompt": "",
"image_size": "landscape_16_9",
"output_format": "jpeg",
"seed": 0
}
```
### Output Schema
The API returns the following output format:
- **`model`** (`string`, _optional_):
model name
- Default: `"ideogram/v4/quality/text-to-image"`
- **`created_at`** (`string`, _optional_):
ISO timestamp of when the request was created (e.g., "2023-04-01T12:34:56.789Z").
- **`id`** (`string`, _optional_):
Unique identifier for the prediction.
- **`outputs`** (`array[string]`, _optional_):
Array of URLs to the generated images. Null when status is not completed.
- **`status`** (`string`, _optional_):
Status of the task: created, processing, completed, or failed.
- **`urls`** (`object`, _optional_):
Object containing related API endpoints.
**Example Response**:
```json
{
"model": "ideogram/v4/quality/text-to-image",
"created_at": "",
"id": "",
"outputs": [
""
],
"status": "",
"urls": {}
}
```
## Usage Examples
### cURL
```bash
# Step 1: Start generation (async)
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateImage" \
-H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram/v4/quality/text-to-image",
"prompt": "",
"image_size": "landscape_16_9",
"output_format": "jpeg",
"seed": 0
}'
# Response will contain: {"code": 200, "data": {"id": "prediction_id", "status": "processing"}}
# Step 2: Poll for result (replace {prediction_id} with the id returned above)
curl -X GET "https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}" \
-H "Authorization: Bearer $ATLASCLOUD_API_KEY"
# Keep polling until status is "completed", "succeeded" or "failed"
# When completed, outputs will contain the generated content URL(s)
```
## Additional Resources
### Documentation
- [Model Playground](https://www.atlascloud.ai/models/ideogram/v4/quality/text-to-image)
A graceful willow tree stands beside a perfectly still lake during sunrise. Long branches gently touch the water while morning mist creates an ethereal atmosphere. Calm, poetic, cinematic.
A graceful willow tree stands beside a perfectly still lake during sunrise. Long branches gently touch the water while morning mist creates an ethereal atmosphere. Calm, poetic, cinematic.