Pereiti prie turinio

Ideogram V3 Edit

Integruoti

Modelio id ideogram/v3/edit
# 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/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "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"

Ši užklausa: 0,06 $ 60 API kreditų · ≈ 6,33 ₽ Paleisti šiame puslapyje

Gauti API raktą
Ideogram · Vaizdas

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

•privaloma

Kaukėtos vaizdo srities užpildymą aprašantis raginys.

•privaloma image_url
Įmeskite failą arba

Generavimo šaltinis, pateikiamas kaip vaizdo URL; jo plotis ir aukštis turi tiksliai sutapti su atitinkamais kaukės matmenimis.

•privaloma mask_url
Įmeskite failą arba

URL pateikiama įpiešimo kaukė; jos plotis ir aukštis turi tiksliai sutapti su atitinkamais įvesties vaizdo matmenimis.

rendering_speed numatytoji BALANCED

Atvaizdavimo spartos nustatymas.

num_images numatytoji 1

Kuriamų vaizdų skaičius.

Išplėstiniai images · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
Įmeskite failą arba

JPEG, PNG arba WebP formato stiliaus nuorodiniai vaizdai. Bendras jų dydis negali viršyti 10 MB.

Stiliaus išankstinė nuostata, kurios pasirinkimas valdo vaizdo generavimą.

Atsitiktinių skaičių generavimo pradžios reikšmė.

Vaizdo stiliaus kodai, pateikiami kaip 8 simbolių šešioliktainės eilutės; naudojant šį sąrašą, praleiskite ir style_reference_images, ir style.

Generuojant naudojama spalvų paletė. Nurodykite pavadinimu pasirinktą išankstinį nustatymą arba aiškias šešioliktaines spalvas per members, pasirinktinai įtraukdami svorius.

POST /run/ideogram/v3/edit?wait=20 kaina → 0,06 $
# 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/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "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"

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie Ideogram V3 Edit

Užpildo kauke pažymėtą vaizdo sritį pagal `prompt`. Vaizdo (`image_url`) ir kaukės (`mask_url`) matmenys turi sutapti. Stilių galima valdyti pamatiniais vaizdais, `style_codes`, `color_palette` arba `style_preset`. Generavimo sparta yra TURBO, BALANCED arba QUALITY, o grąžinti galima nuo 1 iki 8 vaizdų.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
image_urlsneprivalomas images
Tipasurl[] · image
JPEG, PNG arba WebP formato stiliaus nuorodiniai vaizdai. Bendras jų dydis negali viršyti 10 MB.
rendering_speedneprivalomas
Tipasenum
Numatytoji reikšmėBALANCED
TURBOBALANCEDQUALITY
Atvaizdavimo spartos nustatymas.
color_paletteneprivalomas
Tipasobject
Generuojant naudojama spalvų paletė. Nurodykite pavadinimu pasirinktą išankstinį nustatymą arba aiškias šešioliktaines spalvas per members, pasirinktinai įtraukdami svorius.
color_palette.membersneprivalomas
Tipasobject[]
Paletės narių sąrašas, apibrėžiantis paletės spalvas.
color_palette.members[].rgbprivaloma
Tipasobject
Paletės nario spalva, išreikšta RGB.
color_palette.members[].color_weightneprivalomas
Tipasnumber | null
Numatytoji reikšmė0.5
0,05 – 1
Šiai spalvai paletėje priskirtas svoris.
color_palette.nameneprivalomas
Tipasenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Spalvų paletės išankstinio nustatymo pasirinkimas.
style_codesneprivalomas
Tipasstring[]
Vaizdo stiliaus kodai, pateikiami kaip 8 simbolių šešioliktainės eilutės; naudojant šį sąrašą, praleiskite ir style_reference_images, ir style.
expand_promptneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
MagicPrompt naudojimo užklausai generuoti jungiklis.
num_imagesneprivalomas num_outputs
Tipasinteger
Numatytoji reikšmė1
1 – 8
Kuriamų vaizdų skaičius.
seedneprivalomas
Tipasinteger | null
Atsitiktinių skaičių generavimo pradžios reikšmė.
style_presetneprivalomas
Tipasenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
dar +46COLORING_BOOK_ICOLORING_BOOK_IICUBISMDARK_AURADOODLEDOUBLE_EXPOSUREDRAMATIC_CINEMAEDITORIALEMOTIONAL_MINIMALETHEREAL_PARTYEXPIRED_FILMFLAT_ARTFLAT_VECTORFOREST_REVERIEGEO_MINIMALISTGLASS_PRISMGOLDEN_HOURGRAFFITI_IGRAFFITI_IIHALFTONE_PRINTHIGH_CONTRASTHIPPIE_ERAICONICJAPANDI_FUSIONJAZZYLONG_EXPOSUREMAGAZINE_EDITORIALMINIMAL_ILLUSTRATIONMIXED_MEDIAMONOCHROMENIGHTLIFEOIL_PAINTINGOLD_CARTOONSPAINT_GESTUREPOP_ARTRETRO_ETCHINGRIVIERA_POPSPOTLIGHT_80SSTYLIZED_REDSURREAL_COLLAGETRAVEL_POSTERVINTAGE_GEOVINTAGE_POSTERWATERCOLORWEIRDWOODBLOCK_PRINT
Stiliaus išankstinė nuostata, kurios pasirinkimas valdo vaizdo generavimą.
promptprivaloma
Tipasstring
Kaukėtos vaizdo srities užpildymą aprašantis raginys.
image_urlprivaloma image
Tipasurl · image
Generavimo šaltinis, pateikiamas kaip vaizdo URL; jo plotis ir aukštis turi tiksliai sutapti su atitinkamais kaukės matmenimis.
mask_urlprivaloma mask
Tipasurl · image
URL pateikiama įpiešimo kaukė; jos plotis ir aukštis turi tiksliai sutapti su atitinkamais įvesties vaizdo matmenimis.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v3/edit",
  "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": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "images": [
      {
        "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
      }
    ],
    "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"
  }
}
Jūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
images
array of object {url, content_type, file_name, file_size}
seed
integerAtsitiktinių skaičių generavimui naudojama pradžios reikšmė.

Daugiau modelių: Vaizdo redagavimas

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/ideogram/v3/edit.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt