Generate content using ideogram/character-remix
curl --request POST \
--url https://api.kie.ai/api/v1/jobs/createTask \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"model": "ideogram/character-remix",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"prompt": "A fisheye lens selfie photograph taken at night on an urban street. The image is circular with a black border and shows a person wearing dark sunglasses and a black jacket, holding a silver digital camera up to capture the reflection. The background shows a row of shuttered storefronts with red neon lighting visible in the upper portion. The street is empty and dark, with street lights creating a warm glow along the sidewalk. The fisheye effect creates a curved, distorted perspective that bends the straight lines of the street and buildings. The lighting is predominantly red and dark, creating a moody urban atmosphere. The person's reflection shows long dark hair and is positioned in the center of the circular frame. Multiple storefront shutters are visible in the background, creating a repeating pattern of horizontal lines. The overall composition has a cinematic quality with strong contrast between the dark street and the illuminated storefronts above.",
"image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp",
"reference_image_urls": [
"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp"
],
"rendering_speed": "BALANCED",
"style": "AUTO",
"expand_prompt": true,
"image_size": "square_hd",
"num_images": "1",
"strength": 0.8,
"negative_prompt": "",
"image_urls": [],
"reference_mask_urls": ""
}
}
EOFimport requests
url = "https://api.kie.ai/api/v1/jobs/createTask"
payload = {
"model": "ideogram/character-remix",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"prompt": "A fisheye lens selfie photograph taken at night on an urban street. The image is circular with a black border and shows a person wearing dark sunglasses and a black jacket, holding a silver digital camera up to capture the reflection. The background shows a row of shuttered storefronts with red neon lighting visible in the upper portion. The street is empty and dark, with street lights creating a warm glow along the sidewalk. The fisheye effect creates a curved, distorted perspective that bends the straight lines of the street and buildings. The lighting is predominantly red and dark, creating a moody urban atmosphere. The person's reflection shows long dark hair and is positioned in the center of the circular frame. Multiple storefront shutters are visible in the background, creating a repeating pattern of horizontal lines. The overall composition has a cinematic quality with strong contrast between the dark street and the illuminated storefronts above.",
"image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp",
"reference_image_urls": ["https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp"],
"rendering_speed": "BALANCED",
"style": "AUTO",
"expand_prompt": True,
"image_size": "square_hd",
"num_images": "1",
"strength": 0.8,
"negative_prompt": "",
"image_urls": [],
"reference_mask_urls": ""
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'ideogram/character-remix',
callBackUrl: 'https://your-domain.com/api/callback',
input: {
prompt: 'A fisheye lens selfie photograph taken at night on an urban street. The image is circular with a black border and shows a person wearing dark sunglasses and a black jacket, holding a silver digital camera up to capture the reflection. The background shows a row of shuttered storefronts with red neon lighting visible in the upper portion. The street is empty and dark, with street lights creating a warm glow along the sidewalk. The fisheye effect creates a curved, distorted perspective that bends the straight lines of the street and buildings. The lighting is predominantly red and dark, creating a moody urban atmosphere. The person\'s reflection shows long dark hair and is positioned in the center of the circular frame. Multiple storefront shutters are visible in the background, creating a repeating pattern of horizontal lines. The overall composition has a cinematic quality with strong contrast between the dark street and the illuminated storefronts above.',
image_url: 'https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp',
reference_image_urls: [
'https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp'
],
rendering_speed: 'BALANCED',
style: 'AUTO',
expand_prompt: true,
image_size: 'square_hd',
num_images: '1',
strength: 0.8,
negative_prompt: '',
image_urls: [],
reference_mask_urls: ''
}
})
};
fetch('https://api.kie.ai/api/v1/jobs/createTask', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.kie.ai/api/v1/jobs/createTask",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'ideogram/character-remix',
'callBackUrl' => 'https://your-domain.com/api/callback',
'input' => [
'prompt' => 'A fisheye lens selfie photograph taken at night on an urban street. The image is circular with a black border and shows a person wearing dark sunglasses and a black jacket, holding a silver digital camera up to capture the reflection. The background shows a row of shuttered storefronts with red neon lighting visible in the upper portion. The street is empty and dark, with street lights creating a warm glow along the sidewalk. The fisheye effect creates a curved, distorted perspective that bends the straight lines of the street and buildings. The lighting is predominantly red and dark, creating a moody urban atmosphere. The person\'s reflection shows long dark hair and is positioned in the center of the circular frame. Multiple storefront shutters are visible in the background, creating a repeating pattern of horizontal lines. The overall composition has a cinematic quality with strong contrast between the dark street and the illuminated storefronts above.',
'image_url' => 'https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp',
'reference_image_urls' => [
'https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp'
],
'rendering_speed' => 'BALANCED',
'style' => 'AUTO',
'expand_prompt' => true,
'image_size' => 'square_hd',
'num_images' => '1',
'strength' => 0.8,
'negative_prompt' => '',
'image_urls' => [
],
'reference_mask_urls' => ''
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.kie.ai/api/v1/jobs/createTask"
payload := strings.NewReader("{\n \"model\": \"ideogram/character-remix\",\n \"callBackUrl\": \"https://your-domain.com/api/callback\",\n \"input\": {\n \"prompt\": \"A fisheye lens selfie photograph taken at night on an urban street. The image is circular with a black border and shows a person wearing dark sunglasses and a black jacket, holding a silver digital camera up to capture the reflection. The background shows a row of shuttered storefronts with red neon lighting visible in the upper portion. The street is empty and dark, with street lights creating a warm glow along the sidewalk. The fisheye effect creates a curved, distorted perspective that bends the straight lines of the street and buildings. The lighting is predominantly red and dark, creating a moody urban atmosphere. The person's reflection shows long dark hair and is positioned in the center of the circular frame. Multiple storefront shutters are visible in the background, creating a repeating pattern of horizontal lines. The overall composition has a cinematic quality with strong contrast between the dark street and the illuminated storefronts above.\",\n \"image_url\": \"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp\",\n \"reference_image_urls\": [\n \"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp\"\n ],\n \"rendering_speed\": \"BALANCED\",\n \"style\": \"AUTO\",\n \"expand_prompt\": true,\n \"image_size\": \"square_hd\",\n \"num_images\": \"1\",\n \"strength\": 0.8,\n \"negative_prompt\": \"\",\n \"image_urls\": [],\n \"reference_mask_urls\": \"\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.kie.ai/api/v1/jobs/createTask")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"ideogram/character-remix\",\n \"callBackUrl\": \"https://your-domain.com/api/callback\",\n \"input\": {\n \"prompt\": \"A fisheye lens selfie photograph taken at night on an urban street. The image is circular with a black border and shows a person wearing dark sunglasses and a black jacket, holding a silver digital camera up to capture the reflection. The background shows a row of shuttered storefronts with red neon lighting visible in the upper portion. The street is empty and dark, with street lights creating a warm glow along the sidewalk. The fisheye effect creates a curved, distorted perspective that bends the straight lines of the street and buildings. The lighting is predominantly red and dark, creating a moody urban atmosphere. The person's reflection shows long dark hair and is positioned in the center of the circular frame. Multiple storefront shutters are visible in the background, creating a repeating pattern of horizontal lines. The overall composition has a cinematic quality with strong contrast between the dark street and the illuminated storefronts above.\",\n \"image_url\": \"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp\",\n \"reference_image_urls\": [\n \"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp\"\n ],\n \"rendering_speed\": \"BALANCED\",\n \"style\": \"AUTO\",\n \"expand_prompt\": true,\n \"image_size\": \"square_hd\",\n \"num_images\": \"1\",\n \"strength\": 0.8,\n \"negative_prompt\": \"\",\n \"image_urls\": [],\n \"reference_mask_urls\": \"\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.kie.ai/api/v1/jobs/createTask")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"ideogram/character-remix\",\n \"callBackUrl\": \"https://your-domain.com/api/callback\",\n \"input\": {\n \"prompt\": \"A fisheye lens selfie photograph taken at night on an urban street. The image is circular with a black border and shows a person wearing dark sunglasses and a black jacket, holding a silver digital camera up to capture the reflection. The background shows a row of shuttered storefronts with red neon lighting visible in the upper portion. The street is empty and dark, with street lights creating a warm glow along the sidewalk. The fisheye effect creates a curved, distorted perspective that bends the straight lines of the street and buildings. The lighting is predominantly red and dark, creating a moody urban atmosphere. The person's reflection shows long dark hair and is positioned in the center of the circular frame. Multiple storefront shutters are visible in the background, creating a repeating pattern of horizontal lines. The overall composition has a cinematic quality with strong contrast between the dark street and the illuminated storefronts above.\",\n \"image_url\": \"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp\",\n \"reference_image_urls\": [\n \"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp\"\n ],\n \"rendering_speed\": \"BALANCED\",\n \"style\": \"AUTO\",\n \"expand_prompt\": true,\n \"image_size\": \"square_hd\",\n \"num_images\": \"1\",\n \"strength\": 0.8,\n \"negative_prompt\": \"\",\n \"image_urls\": [],\n \"reference_mask_urls\": \"\"\n }\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_ideogram_1765179916266"
}
}Ideogram
Ideogram - character-remix
Image generation by ideogram/character-remix
POST
/
api
/
v1
/
jobs
/
createTask
Generate content using ideogram/character-remix
curl --request POST \
--url https://api.kie.ai/api/v1/jobs/createTask \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"model": "ideogram/character-remix",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"prompt": "A fisheye lens selfie photograph taken at night on an urban street. The image is circular with a black border and shows a person wearing dark sunglasses and a black jacket, holding a silver digital camera up to capture the reflection. The background shows a row of shuttered storefronts with red neon lighting visible in the upper portion. The street is empty and dark, with street lights creating a warm glow along the sidewalk. The fisheye effect creates a curved, distorted perspective that bends the straight lines of the street and buildings. The lighting is predominantly red and dark, creating a moody urban atmosphere. The person's reflection shows long dark hair and is positioned in the center of the circular frame. Multiple storefront shutters are visible in the background, creating a repeating pattern of horizontal lines. The overall composition has a cinematic quality with strong contrast between the dark street and the illuminated storefronts above.",
"image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp",
"reference_image_urls": [
"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp"
],
"rendering_speed": "BALANCED",
"style": "AUTO",
"expand_prompt": true,
"image_size": "square_hd",
"num_images": "1",
"strength": 0.8,
"negative_prompt": "",
"image_urls": [],
"reference_mask_urls": ""
}
}
EOFimport requests
url = "https://api.kie.ai/api/v1/jobs/createTask"
payload = {
"model": "ideogram/character-remix",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"prompt": "A fisheye lens selfie photograph taken at night on an urban street. The image is circular with a black border and shows a person wearing dark sunglasses and a black jacket, holding a silver digital camera up to capture the reflection. The background shows a row of shuttered storefronts with red neon lighting visible in the upper portion. The street is empty and dark, with street lights creating a warm glow along the sidewalk. The fisheye effect creates a curved, distorted perspective that bends the straight lines of the street and buildings. The lighting is predominantly red and dark, creating a moody urban atmosphere. The person's reflection shows long dark hair and is positioned in the center of the circular frame. Multiple storefront shutters are visible in the background, creating a repeating pattern of horizontal lines. The overall composition has a cinematic quality with strong contrast between the dark street and the illuminated storefronts above.",
"image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp",
"reference_image_urls": ["https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp"],
"rendering_speed": "BALANCED",
"style": "AUTO",
"expand_prompt": True,
"image_size": "square_hd",
"num_images": "1",
"strength": 0.8,
"negative_prompt": "",
"image_urls": [],
"reference_mask_urls": ""
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'ideogram/character-remix',
callBackUrl: 'https://your-domain.com/api/callback',
input: {
prompt: 'A fisheye lens selfie photograph taken at night on an urban street. The image is circular with a black border and shows a person wearing dark sunglasses and a black jacket, holding a silver digital camera up to capture the reflection. The background shows a row of shuttered storefronts with red neon lighting visible in the upper portion. The street is empty and dark, with street lights creating a warm glow along the sidewalk. The fisheye effect creates a curved, distorted perspective that bends the straight lines of the street and buildings. The lighting is predominantly red and dark, creating a moody urban atmosphere. The person\'s reflection shows long dark hair and is positioned in the center of the circular frame. Multiple storefront shutters are visible in the background, creating a repeating pattern of horizontal lines. The overall composition has a cinematic quality with strong contrast between the dark street and the illuminated storefronts above.',
image_url: 'https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp',
reference_image_urls: [
'https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp'
],
rendering_speed: 'BALANCED',
style: 'AUTO',
expand_prompt: true,
image_size: 'square_hd',
num_images: '1',
strength: 0.8,
negative_prompt: '',
image_urls: [],
reference_mask_urls: ''
}
})
};
fetch('https://api.kie.ai/api/v1/jobs/createTask', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.kie.ai/api/v1/jobs/createTask",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'ideogram/character-remix',
'callBackUrl' => 'https://your-domain.com/api/callback',
'input' => [
'prompt' => 'A fisheye lens selfie photograph taken at night on an urban street. The image is circular with a black border and shows a person wearing dark sunglasses and a black jacket, holding a silver digital camera up to capture the reflection. The background shows a row of shuttered storefronts with red neon lighting visible in the upper portion. The street is empty and dark, with street lights creating a warm glow along the sidewalk. The fisheye effect creates a curved, distorted perspective that bends the straight lines of the street and buildings. The lighting is predominantly red and dark, creating a moody urban atmosphere. The person\'s reflection shows long dark hair and is positioned in the center of the circular frame. Multiple storefront shutters are visible in the background, creating a repeating pattern of horizontal lines. The overall composition has a cinematic quality with strong contrast between the dark street and the illuminated storefronts above.',
'image_url' => 'https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp',
'reference_image_urls' => [
'https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp'
],
'rendering_speed' => 'BALANCED',
'style' => 'AUTO',
'expand_prompt' => true,
'image_size' => 'square_hd',
'num_images' => '1',
'strength' => 0.8,
'negative_prompt' => '',
'image_urls' => [
],
'reference_mask_urls' => ''
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.kie.ai/api/v1/jobs/createTask"
payload := strings.NewReader("{\n \"model\": \"ideogram/character-remix\",\n \"callBackUrl\": \"https://your-domain.com/api/callback\",\n \"input\": {\n \"prompt\": \"A fisheye lens selfie photograph taken at night on an urban street. The image is circular with a black border and shows a person wearing dark sunglasses and a black jacket, holding a silver digital camera up to capture the reflection. The background shows a row of shuttered storefronts with red neon lighting visible in the upper portion. The street is empty and dark, with street lights creating a warm glow along the sidewalk. The fisheye effect creates a curved, distorted perspective that bends the straight lines of the street and buildings. The lighting is predominantly red and dark, creating a moody urban atmosphere. The person's reflection shows long dark hair and is positioned in the center of the circular frame. Multiple storefront shutters are visible in the background, creating a repeating pattern of horizontal lines. The overall composition has a cinematic quality with strong contrast between the dark street and the illuminated storefronts above.\",\n \"image_url\": \"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp\",\n \"reference_image_urls\": [\n \"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp\"\n ],\n \"rendering_speed\": \"BALANCED\",\n \"style\": \"AUTO\",\n \"expand_prompt\": true,\n \"image_size\": \"square_hd\",\n \"num_images\": \"1\",\n \"strength\": 0.8,\n \"negative_prompt\": \"\",\n \"image_urls\": [],\n \"reference_mask_urls\": \"\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.kie.ai/api/v1/jobs/createTask")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"ideogram/character-remix\",\n \"callBackUrl\": \"https://your-domain.com/api/callback\",\n \"input\": {\n \"prompt\": \"A fisheye lens selfie photograph taken at night on an urban street. The image is circular with a black border and shows a person wearing dark sunglasses and a black jacket, holding a silver digital camera up to capture the reflection. The background shows a row of shuttered storefronts with red neon lighting visible in the upper portion. The street is empty and dark, with street lights creating a warm glow along the sidewalk. The fisheye effect creates a curved, distorted perspective that bends the straight lines of the street and buildings. The lighting is predominantly red and dark, creating a moody urban atmosphere. The person's reflection shows long dark hair and is positioned in the center of the circular frame. Multiple storefront shutters are visible in the background, creating a repeating pattern of horizontal lines. The overall composition has a cinematic quality with strong contrast between the dark street and the illuminated storefronts above.\",\n \"image_url\": \"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp\",\n \"reference_image_urls\": [\n \"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp\"\n ],\n \"rendering_speed\": \"BALANCED\",\n \"style\": \"AUTO\",\n \"expand_prompt\": true,\n \"image_size\": \"square_hd\",\n \"num_images\": \"1\",\n \"strength\": 0.8,\n \"negative_prompt\": \"\",\n \"image_urls\": [],\n \"reference_mask_urls\": \"\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.kie.ai/api/v1/jobs/createTask")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"ideogram/character-remix\",\n \"callBackUrl\": \"https://your-domain.com/api/callback\",\n \"input\": {\n \"prompt\": \"A fisheye lens selfie photograph taken at night on an urban street. The image is circular with a black border and shows a person wearing dark sunglasses and a black jacket, holding a silver digital camera up to capture the reflection. The background shows a row of shuttered storefronts with red neon lighting visible in the upper portion. The street is empty and dark, with street lights creating a warm glow along the sidewalk. The fisheye effect creates a curved, distorted perspective that bends the straight lines of the street and buildings. The lighting is predominantly red and dark, creating a moody urban atmosphere. The person's reflection shows long dark hair and is positioned in the center of the circular frame. Multiple storefront shutters are visible in the background, creating a repeating pattern of horizontal lines. The overall composition has a cinematic quality with strong contrast between the dark street and the illuminated storefronts above.\",\n \"image_url\": \"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp\",\n \"reference_image_urls\": [\n \"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp\"\n ],\n \"rendering_speed\": \"BALANCED\",\n \"style\": \"AUTO\",\n \"expand_prompt\": true,\n \"image_size\": \"square_hd\",\n \"num_images\": \"1\",\n \"strength\": 0.8,\n \"negative_prompt\": \"\",\n \"image_urls\": [],\n \"reference_mask_urls\": \"\"\n }\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_ideogram_1765179916266"
}
}Query Task Status
After submitting a task, use the unified query endpoint to check progress and retrieve results:Get Task Details
Learn how to query task status and retrieve generation results
For production use, we recommend using the
callBackUrl parameter to receive automatic notifications when generation completes, rather than polling the status endpoint.Related Resources
Market Overview
Explore all available models
Common API
Check credits and account usage
Authorizations
All APIs require authentication via Bearer Token.
Get API Key:
- Visit API Key Management Page to get your API Key
Usage: Add to request header: Authorization: Bearer YOUR_API_KEY
Note:
- Keep your API Key secure and do not share it with others
- If you suspect your API Key has been compromised, reset it immediately in the management page
Body
application/json
The model name to use for generation. Required field.
- Must be
ideogram/character-remixfor this endpoint
Available options:
ideogram/character-remix Example:
"ideogram/character-remix"
The URL to receive generation task completion updates. Optional but recommended for production use.
- System will POST task status and results to this URL when generation completes
- Callback includes generated content URLs and task information
- Your callback endpoint should accept POST requests with JSON payload containing results
- Alternatively, use the Get Task Details endpoint to poll task status
- To ensure callback security, see Webhook Verification Guide for signature verification implementation
Example:
"https://your-domain.com/api/callback"
Input parameters for the generation task
Show child attributes
Show child attributes
Response
Request successful
Response status code
- 200: Success - Request has been processed successfully
- 401: Unauthorized - Authentication credentials are missing or invalid
- 402: Insufficient Credits - Account does not have enough credits to perform the operation
- 404: Not Found - The requested resource or endpoint does not exist
- 422: Validation Error - The request parameters failed validation checks
- 429: Rate Limited - Request limit has been exceeded for this resource
- 455: Service Unavailable - System is currently undergoing maintenance
- 500: Server Error - An unexpected error occurred while processing the request
- 501: Generation Failed - Content generation task failed
- 505: Feature Disabled - The requested feature is currently disabled
Available options:
200, 401, 402, 404, 422, 429, 455, 500, 501, 505 Response message, error description when failed
Example:
"success"
Show child attributes
Show child attributes