Ideogram AI 绘图支持

curl -X POST https://aihubmix.com/ideogram/v1/ideogram-v3/generate \
  -H "Api-Key: sk-***" \
  -H "Content-Type: multipart/form-data" \
  -F prompt="Delicate 3D cover design with various combat machines flying from an portal. The machines have different shapes, sizes, and colors. The portal is emitting swirling energy. The background contains a futuristic city with tall buildings. The text \"One Gateway, Infinite Models\" is placed in the center with neon lights, expansive view, cinematic lighting, vivid color, bright tone. clean text, cyber punk, smooth render" \
  -F rendering_speed="QUALITY" \
  -F num_images="2" \
  -F aspect_ratio="2x1"

import requests
import os

# 准备请求数据 - 使用字典而不是JSON
data = {
  "prompt": "Delicate 3D cover design with various combat machines flying from an portal. The machines have different shapes, sizes, and colors. The portal is emitting swirling energy. The background contains a futuristic city with tall buildings. The text \"One Gateway, Infinite Models\" is placed in the center with neon lights, expansive view, cinematic lighting, vivid color, bright tone. clean text, cyber punk, smooth render",
  "rendering_speed": "QUALITY",
  "num_images": "2",
  "aspect_ratio": "2x1",
  "magic_prompt": "AUTO",
  "style_type": "AUTO",
  "negative_prompt": "blurry, watermark"
}

# Content-Type 为 multipart/form-data
files = {}
for key, value in data.items():
    files[key] = (None, str(value))  # 将每个数据字段作为表单字段发送

response = requests.post(
  "https://aihubmix.com/ideogram/v1/ideogram-v3/generate",
  headers={
    "Api-Key": "sk-***" # 换成你在 AiHubMix 生成的密钥
  },
  files=files
)
print(response.json())

# save output image to file
response_json = response.json()
if response.ok and 'data' in response_json and len(response_json['data']) > 0:
    image_data = response_json['data'][0]['url']  # 正确获取图片 URL
    image_response = requests.get(image_data)
    if image_response.ok:
        with open('output.png', 'wb') as f:
            f.write(image_response.content)
        print("图片已保存到 output.png")
    else:
        print(f"获取图片失败：{image_response.status_code}")
else:
    print("API 请求失败或返回数据中没有图片")

import requests
import os

data = {
  "prompt": "Delicate 3D cover design with various combat machines flying from an portal. The machines have different shapes, sizes, and colors. The portal is emitting swirling energy. The background contains a futuristic city with tall buildings. The text \"One Gateway, Infinite Models\" is placed in the center with neon lights, expansive view, cinematic lighting, vivid color, bright tone. clean text, cyber punk, smooth render",
  "rendering_speed": "QUALITY",
  "num_images": 2,
  # "seed": "998", # 多张图时不要使用 seed
  "aspect_ratio": "2x1", 
  "magic_prompt": "AUTO",
  "style_type": "AUTO",
  "negative_prompt": "blurry, watermark",
}

# initialize files parameter
files = None

# 样式参考图路径
style_reference_path = "yourpath/reference-image.jpeg"
use_reference_image = True

if use_reference_image and os.path.exists(style_reference_path):
    # 如果使用参考图片且文件存在，则设置 files 参数
    files = [
        ("style_reference_images", open(style_reference_path, "rb")),
        # 如果需要添加多个样式参考图片，可以按如下方式添加：
        # ("style_reference_images", open("第二张参考图片路径", "rb")),
    ]
elif use_reference_image:
    print(f"警告：样式参考图片未找到：{style_reference_path}")

response = requests.post(
  "https://aihubmix.com/ideogram/v1/ideogram-v3/generate",
  headers={
    "Api-Key": "sk-***" # 换成你在 AiHubMix 生成的密钥
  },
  data=data,
  files=files
)
print(response.json())

# save output image to file
response_json = response.json()
if response.ok and 'data' in response_json and len(response_json['data']) > 0:
    image_data = response_json['data'][0]['url']  # 正确获取图片 URL
    image_response = requests.get(image_data)
    if image_response.ok:
        with open('output.png', 'wb') as f:
            f.write(image_response.content)
        print("图片已保存到 output.png")
    else:
        print(f"获取图片失败：{image_response.status_code}")
else:
    print("API 请求失败或返回数据中没有图片")

import requests
import os

data = {
  "prompt": "bird playing with a cat in the snow, pixel art style",
  "image_weight": "60",
  "rendering_speed": "QUALITY",
  "num_images": 1,
  "seed": 1,
  "aspect_ratio": "16x9", 
  "magic_prompt": "AUTO",
  "style_type": "AUTO",
  "negative_prompt": "blurry, bad anatomy, watermark",
}

# 原图 - 必填
source_image_path = "yourpath/image.jpeg"
if not os.path.exists(source_image_path):
    raise FileNotFoundError(f"源图片未找到：{source_image_path}")

# initialize files parameter
files = None

# 样式参考图路径
style_reference_path = "yourpath/reference-image.png"
use_reference_image = True

# 准备文件上传
with open(source_image_path, "rb") as image_file:
    if use_reference_image and os.path.exists(style_reference_path):
        # 如果使用参考图片且文件存在，则设置 files 参数
        files = {
            "image": image_file,
            "style_reference_images": open(style_reference_path, "rb"),
        }
    else:
        if use_reference_image:
            print(f"警告：样式参考图片未找到：{style_reference_path}")
        files = {
            "image": image_file,
        }

    response = requests.post(
      "https://aihubmix.com/ideogram/v1/ideogram-v3/remix",
      headers={
        "Api-Key": "sk-***" # 换成你在 AiHubMix 生成的密钥
      },
      data=data,
      files=files
    )
print(response.json())

# save output image to file
response_json = response.json()
if response.ok and 'data' in response_json and len(response_json['data']) > 0:
    image_data = response_json['data'][0]['url']  # 正确获取图片 URL
    image_response = requests.get(image_data)
    if image_response.ok:
        with open('output.png', 'wb') as f:
            f.write(image_response.content)
        print("图片已保存到 output.png")
    else:
        print(f"获取图片失败：{image_response.status_code}")
else:
    print("API 请求失败或返回数据中没有图片")
    print(f"错误详情：{response_json}")

import requests
import os

# 原图 - 必填
source_image_path = "yourpath/image.jpeg"
# mask - 必填
mask_image_path = "yourpath/mask.jpg"

if not os.path.exists(source_image_path):
    raise FileNotFoundError(f"源图片未找到：{source_image_path}")

with open(source_image_path, "rb") as image_file, open(mask_image_path, "rb") as mask_file:
    response = requests.post(
        "https://aihubmix.com/ideogram/v1/ideogram-v3/edit",
        headers={
            "Api-Key": "sk-***" # 换成你在 AiHubMix 生成的密钥
        },
        data={
            "prompt": "remove text",
            "rendering_speed": "DEFAULT",
            "num_images": 1,
            "seed": 1,
            "aspect_ratio": "16x9",
            "magic_prompt": "AUTO",
            "style_type": "AUTO",
            "negative_prompt": "blurry, bad anatomy, watermark",
        },
        files={
            "image": image_file,
            "mask": mask_file,
        }
    )

print(response.json())

# save output image to file
response_json = response.json()
if response.ok and 'data' in response_json and len(response_json['data']) > 0:
    image_data = response_json['data'][0]['url']  # 正确获取图片 URL
    image_response = requests.get(image_data)
    if image_response.ok:
        with open('output.png', 'wb') as f:
            f.write(image_response.content)
        print("图片已保存到 output.png")
    else:
        print(f"获取图片失败：{image_response.status_code}")
else:
    print("API 请求失败或返回数据中没有图片")
    print(f"错误详情：{response_json}")

import requests
import os

data = {
  "prompt": "bird playing with a cat in the snow, pixel art style",
  "rendering_speed": "QUALITY",
  "num_images": 1,
  "seed": 1,
  # no "aspect_ratio"
  "magic_prompt": "AUTO",
  "style_type": "AUTO",
  # no "negative_prompt"
}

# 原图 - 必填
source_image_path = "yourpath/image.png"
if not os.path.exists(source_image_path):
    raise FileNotFoundError(f"源图片未找到：{source_image_path}")

# initialize files parameter
files = None

# 样式参考图路径
style_reference_path = "yourpath/reference-image.png"
use_reference_image = True

# 准备文件上传
with open(source_image_path, "rb") as image_file:
    if use_reference_image and os.path.exists(style_reference_path):
        # 如果使用参考图片且文件存在，则设置 files 参数
        files = {
            "image": image_file,
            "style_reference_images": open(style_reference_path, "rb"),
        }
    else:
        if use_reference_image:
            print(f"警告：样式参考图片未找到：{style_reference_path}")
        files = {
            "image": image_file,
        }

    response = requests.post(
      "https://aihubmix.com/ideogram/v1/ideogram-v3/replace-background",
      headers={
        "Api-Key": "sk-***" # 换成你在 AiHubMix 生成的密钥
      },
      data=data,
      files=files
    )
print(response.json())

# save output image to file
response_json = response.json()
if response.ok and 'data' in response_json and len(response_json['data']) > 0:
    image_data = response_json['data'][0]['url']  # 正确获取图片 URL
    image_response = requests.get(image_data)
    if image_response.ok:
        with open('output.png', 'wb') as f:
            f.write(image_response.content)
        print("图片已保存到 output.png")
    else:
        print(f"获取图片失败：{image_response.status_code}")
else:
    print("API 请求失败或返回数据中没有图片")
    print(f"错误详情：{response_json}")

import requests
import os

url = "https://aihubmix.com/ideogram/generate"

payload = { "image_request": {
        "prompt": "3D cartoon, An adorable white owl baby with tilted head, shiny amber eyes with highlight, fluffy body, standing on a trunk with moss and lots of glowing mushrooms, Close up, cinematic lighting, low angle, deep sense of depth. The background is a magical spring landscape, cute and esthetic, huge title design \"Always curious\"", #string 可选
        "negative_prompt": "blurry, bad anatomy, watermark",
        "aspect_ratio": "ASPECT_3_2",  # 可选 include ASPECT_1_1(Default), ASPECT_3_2, ASPECT_2_3, ASPECT_4_3, ASPECT_3_4, ASPECT_16_9, ASPECT_9_16, SPECT_16_10, ASPECT_10_16
        "model": "V_2",
        "num_images": 2, #integer 可选 >=1 <=8 Defaults to 1
        "magic_prompt_option": "AUTO", # string 可选 AUTO, ON, OFF
        #"seed": "2" #integer 可选 >=0 <=2147483647
        "style_type": "RENDER_3D" # string 可选 AUTO/GENERAL/REALISTIC/DESIGN/RENDER_3D/ANIME, 仅适用于 V_2 及以上版本
    } }
headers = {
    "Api-Key": os.getenv("AIHUBMIX_API_KEY"),
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = 'https://aihubmix.com/ideogram/describe';
const form = new FormData();
form.append('image_file', '<file1>');

const options = {method: 'POST', headers: {'Api-Key': '<apiKey>'}};

options.body = form;

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl -X POST https://aihubmix.com/ideogram/generate \
     -H "Api-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "image_request": {
    "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
    "aspect_ratio": "ASPECT_10_16",
    "model": "V_2",
    "magic_prompt_option": "AUTO"
  }
}'

import requests
import os

url = "https://aihubmix.com/ideogram/eidt"

files = {
    "image_file": open('<file1>', 'rb'), # 必须
    "mask": "open('<file1>', 'rb')" # 必须
}

payload = {
    "prompt": "\"prompt\"", # 必须
    "model": "V_2",  # 必须，only supported for V_2 and V_2_TURBO.
    "magic_prompt_option": ,
    "num_images":1, # integer 可选 >=1 <=8 Defaults to 1
    "seed": , # integer 可选 >=0 <=2147483647
    "style_type":
16}
headers = {"Api-Key": os.getenv("AIHUBMIX_API_KEY")}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.json()

# close file
files["image_file"].close()
files["mask"].close()

const url = 'https://aihubmix.com/ideogram/edit';
const form = new FormData();
form.append('image_file', '<file1>');
form.append('mask', '<file1>');
form.append('prompt', '"prompt"');
form.append('model', '"V_1"');
form.append('magic_prompt_option', '');
form.append('num_images', '');
form.append('seed', '');
form.append('style_type', '');

const options = {method: 'POST', headers: {'Api-Key': '<apiKey>'}};

options.body = form;

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl -X POST https://aihubmix.com/ideogram/edit \
     -H "Api-Key: <apiKey>" \
     -H "Content-Type: multipart/form-data" \
     -F image_file=@<file1> \
     -F mask=@<file1> \
     -F prompt="prompt" \
     -F model="V_1"

import requests
import os

url = "https://aihubmix.com/ideogram/remix"

files = { "image_file": open('<file1>', 'rb') }
payload = {"image_request": '''{
    "prompt": "watercolor",
    "aspect_ratio": "ASPECT_10_16",
    "image_weight": 50,
    "magic_prompt_option": "ON",
    "model": "V_2"
}'''}

headers = {"Api-Key": os.getenv("AIHUBMIX_API_KEY")}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.json())

const url = 'https://aihubmix.com/ideogram/remix';
const form = new FormData();
form.append('image_request', '{
  "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
  "aspect_ratio": "ASPECT_10_16",
  "image_weight": 50,
  "magic_prompt_option": "ON",
  "model": "V_2"
}');
form.append('image_file', '<file1>');

const options = {method: 'POST', headers: {'Api-Key': '<apiKey>'}};

options.body = form;

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl -X POST https://aihubmix.com/ideogram/remix \
     -H "Api-Key: <apiKey>" \
     -H "Content-Type: multipart/form-data" \
     -F image_request='{
  "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
  "aspect_ratio": "ASPECT_10_16",
  "image_weight": 50,
  "magic_prompt_option": "ON",
  "model": "V_2"
}' \
     -F image_file=@<file1>

import requests
import os

url = "https://aihubmix.com/ideogram/upscale"

files = { "image_file": open('<file1>', 'rb') }
payload = { "image_request": "{}" }
headers = {"Api-Key": os.getenv("AIHUBMIX_API_KEY")}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.json())

const url = 'https://aihubmix.com/ideogram/upscale';
const form = new FormData();
form.append('image_request', '{}');
form.append('image_file', '<file1>');

const options = {method: 'POST', headers: {'Api-Key': '<apiKey>'}};

options.body = form;

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl -X POST https://aihubmix.com/ideogram/upscale \
     -H "Api-Key: <apiKey>" \
     -H "Content-Type: multipart/form-data" \
     -F image_request='{}' \
     -F image_file=@<file1>

import requests
import os

url = "https://aihubmix.com/ideogram/describe"

files = { "image_file": open('<file1>', 'rb') }
headers = {"Api-Key": os.getenv("AIHUBMIX_API_KEY")}

response = requests.post(url, files=files, headers=headers)

print(response.json())

# close file
files["image_file"].close()

const url = 'https://aihubmix.com/ideogram/describe';
const form = new FormData();
form.append('image_file', '<file1>');

const options = {method: 'POST', headers: {'Api-Key': '<apiKey>'}};

options.body = form;

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl -X POST https://aihubmix.com/ideogram/describe \
     -H "Api-Key: <apiKey>" \
     -H "Content-Type: multipart/form-data" \
     -F image_file=@<file1>