Мазмұнға өту

Ideogram · v3 · Layerize Text

Интеграциялау

Модель идентификаторы ideogram/v3/layerize-text
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ideogram/v3/layerize-text?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Осы сұрау: 0,09 $ 90 API кредиті · ≈ 9,49 ₽ Осы бетте іске қосу

API кілтін алу
Ideogram · Кескін

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

Қабаттарға түрлендіруді бағыттайтын қосымша нұсқау.

•міндетті image_url
Файлды тастаңыз немесе

Қабаттарға түрлендірілетін жазық графикалық кескіннің URL-і. Қабылданатын форматтар: JPEG, PNG және WebP; ең үлкен файл өлшемі 10 MB.

Қосымша font_file_h1_url · font_name_h1 · font_file_h2_url · font_name_h2 · font_file_body_url · font_name_body · font_file_small_url · font_name_small · seed

h1 мәтініне арналған қаріп файлының URL-і; font_name_h1 параметрімен өзара үйлеспейді.

h1 мәтініне арналған қаріп атауы; font_file_h1_url параметрімен өзара үйлеспейді.

h2 мәтініне арналған қаріп файлының URL-і; font_name_h2 параметрімен өзара үйлеспейді.

h2 мәтініне арналған қаріп атауы; font_file_h2_url параметрімен өзара үйлеспейді.

Негізгі мәтінге арналған қаріп файлының URL-і; font_name_body параметрімен өзара үйлеспейді.

Негізгі мәтінге арналған қаріп атауы; font_file_body_url параметрімен өзара үйлеспейді.

Кіші мәтінге арналған қаріп файлының URL-і; font_name_small параметрімен өзара үйлеспейді.

Кіші мәтінге арналған қаріп атауы; font_file_small_url параметрімен өзара үйлеспейді.

Кездейсоқ сандар генераторы пайдаланатын seed.

POST /run/ideogram/v3/layerize-text?wait=20 бағасы → 0,09 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ideogram/v3/layerize-text?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Осы сұрауды іске қосу

Кілтіңіз осы браузерде қалады: ол тек Doitong API-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Ideogram · v3 · Layerize Text туралы

Жазық графиканы (`image_url`, JPEG, PNG немесе WebP, 10MB дейін) қабылдап, мәтіні өшірілген фонды, бөлініп алынған кескін қабаттарын, құрылымдалған мәтін контейнерлерін және қайта біріктіруге арналған қабаттасушы HTML қайтарады. h1, h2, негізгі және ұсақ мәтін үшін қаріптерді атауы немесе файлдың URL мекенжайы арқылы орнатуға болады. Міндетті емес `prompt` және `seed` қабылданады.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
image_urlміндетті image
Түріurl · image
Қабаттарға түрлендірілетін жазық графикалық кескіннің URL-і. Қабылданатын форматтар: JPEG, PNG және WebP; ең үлкен файл өлшемі 10 MB.
promptміндетті емес
Түріstring | null
Қабаттарға түрлендіруді бағыттайтын қосымша нұсқау.
seedміндетті емес
Түріinteger | null
Кездейсоқ сандар генераторы пайдаланатын seed.
font_file_h1_urlміндетті емес
Түріstring | null
h1 мәтініне арналған қаріп файлының URL-і; font_name_h1 параметрімен өзара үйлеспейді.
font_name_h1міндетті емес
Түріstring | null
h1 мәтініне арналған қаріп атауы; font_file_h1_url параметрімен өзара үйлеспейді.
font_file_h2_urlміндетті емес
Түріstring | null
h2 мәтініне арналған қаріп файлының URL-і; font_name_h2 параметрімен өзара үйлеспейді.
font_name_h2міндетті емес
Түріstring | null
h2 мәтініне арналған қаріп атауы; font_file_h2_url параметрімен өзара үйлеспейді.
font_file_body_urlміндетті емес
Түріstring | null
Негізгі мәтінге арналған қаріп файлының URL-і; font_name_body параметрімен өзара үйлеспейді.
font_name_bodyміндетті емес
Түріstring | null
Негізгі мәтінге арналған қаріп атауы; font_file_body_url параметрімен өзара үйлеспейді.
font_file_small_urlміндетті емес
Түріstring | null
Кіші мәтінге арналған қаріп файлының URL-і; font_name_small параметрімен өзара үйлеспейді.
font_name_smallміндетті емес
Түріstring | null
Кіші мәтінге арналған қаріп атауы; font_file_small_url параметрімен өзара үйлеспейді.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың file_url мәнін қабылдайды. Файлдар

Шығыс

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v3/layerize-text",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 90,
    "usd": "0.09",
    "charged": 90,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "prompt": "string",
    "text_containers": [
      {}
    ],
    "text_html": "string",
    "image_layers": [
      {}
    ],
    "seed": 42
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Файлдарыңыз — таңдауыңызӘр outputs[].url — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
image
object {url, content_type, file_name, file_size}Мәтіні жойылғаннан кейінгі фон кескіні.
prompt
stringMagicPrompt кеңейтуінен кейінгі қабаттау нұсқауын қамтиды, сондықтан ол бастапқы кіріске сәйкес келмеуі мүмкін.
text_containers
array of object | nullКонтейнерлер, элементтер және span-дар иерархиясы ретінде ұйымдастырылған мәтін контейнерлері.
text_html
string | nullМәтінді фон кескініне композициялау үшін пайдаланылатын бейнеленген HTML қабаты.
image_layers
array of objectДизайннан бөлініп алынған кескін қабаттары.
seed
integerКездейсоқ сандарды генерациялауға пайдаланылатын seed мәні.

Қосымша модельдер: Кескінді өңдеу

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/ideogram/v3/layerize-text.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt