Flexible parameters
Configure 4 documented parameters, including mask_url, output_count, rendering_speed, source_image_url.
Targeted editing while preserving text accuracy
curl -X POST https://runapi.ai/api/v1/ideogram_v3/edit_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v3-edit",
"image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
"prompt": "Create a movie poster for 'The Last Frontier' with the title in bold serif at the top, a space station in the background."
}'
import { IdeogramV3Client } from "@runapi.ai/ideogram-v3";
const client = new IdeogramV3Client();
const result = await client.editImage.run({
model: "ideogram-v3-edit",
image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "Create a movie poster for 'The Last Frontier' with the title in bold serif at the top, a space station in the background.",
});
import os
import requests
response = requests.post(
"https://runapi.ai/api/v1/ideogram_v3/edit_image",
headers={"Authorization": f"Bearer {os.environ['RUNAPI_API_KEY']}"},
json={"model":"ideogram-v3-edit","image_url":"https://cdn.runapi.ai/public/samples/image.jpg","prompt":"Create a movie poster for 'The Last Frontier' with the title in bold serif at the top, a space station in the background."}
)
response.raise_for_status()
<?php
$client = curl_init("https://runapi.ai/api/v1/ideogram_v3/edit_image");
curl_setopt_array($client, [
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("RUNAPI_API_KEY"), "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode([
'model' => 'ideogram-v3-edit',
'image_url' => 'https://cdn.runapi.ai/public/samples/image.jpg',
'prompt' => 'Create a movie poster for \'The Last Frontier\' with the title in bold serif at the top, a space station in the background.',
])
]);
$response = curl_exec($client);
RunApi client = new RunApi(System.getenv("RUNAPI_API_KEY"));
Task task = client.editImage().run({"model":"ideogram-v3-edit","image_url":"https://cdn.runapi.ai/public/samples/image.jpg","prompt":"Create a movie poster for 'The Last Frontier' with the title in bold serif at the top, a space station in the background."});
task.waitForResult();
require "runapi/ideogram_v3"
client = RunApi::IdeogramV3::Client.new
result = client.edit_image.run(
model: "ideogram-v3-edit",
image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "Create a movie poster for 'The Last Frontier' with the title in bold serif at the top, a space station in the background."
)
client := runapi.NewClient(os.Getenv("RUNAPI_API_KEY"))
task, err := client.editImage.Run({"model":"ideogram-v3-edit","image_url":"https://cdn.runapi.ai/public/samples/image.jpg","prompt":"Create a movie poster for 'The Last Frontier' with the title in bold serif at the top, a space station in the background."})
if err != nil { log.Fatal(err) }
task.Wait()
$ runapi generate \
--model ideogram-v3-edit \
--endpoint edit_image \
--wait
7 versions available
Pick any model and generate in seconds.
| Provider | Ideogram |
| Model ID | ideogram-v3-edit |
| Modality | Image |
| Task types | Asynchronous |
| API endpoint | /api/v1/ideogram_v3/edit_image |
| Billing unit | call |
| Input parameters | mask_url, output_count, rendering_speed, source_image_url |
| Catalog status | Operational |
Sign up for free and create an API key for ideogram-v3-edit from the dashboard.
POST to /api/v1/ideogram_v3/edit_image with the ideogram-v3-edit model slug and your parameters.
Poll the task or follow the callback to retrieve the completed ideogram-v3-edit result.
Configure 4 documented parameters, including mask_url, output_count, rendering_speed, source_image_url.
Exposes 1 public endpoint(s): edit_image.
Metered by call with no subscription requirement.
mask_urlNo description available.
output_countNo description available. (1, 2, 3, 4)
rendering_speedNo description available. (turbo, balanced, quality)
source_image_urlNo description available.
Auto-generate lifestyle product photos for e-commerce catalogs that lack studio photography.
Rapidly concept environments and characters before committing to final art.
Generate unique cover art and illustrations for blog posts and articles at scale.
Pass the model ID shown in the quickstart.
Per-key rate limits scale with your usage tier. The pricing page shows current limits. If you need higher throughput, contact support to discuss tier upgrades.
Yes. Variant is a parameter in the request. Switch by changing the model ID — no code changes, no re-authentication, no separate billing setup. All variants share the same API key and request shape.
Where streaming is available, RunAPI streams end-to-end. LLM models support token-level streaming. Media models use async task polling or webhook callbacks for result delivery.
Open an issue on the public GitHub repo or email support at [email protected]. Include the task ID and model ID so the team can investigate the specific generation.
No. Your RunAPI API key is enough to access this variant and every other model in the catalog. You do not need accounts with the underlying provider.
We're here to help with enterprise setup, integrations, and technical questions.
Contact Us