Przejdź do treści

Ideogram V3 Edit

Integracja

Identyfikator modelu 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"

To żądanie: 0,06 $ 60 kredytów API · ≈ 6,39 ₽ Uruchom na tej stronie

Uzyskaj klucz API
Ideogram · Obraz

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane

Prompt opisujący wypełnienie maskowanego obszaru obrazu.

•wymagane image_url
Upuść plik lub

Źródło generowania podane jako adres URL obrazu; jego szerokość i wysokość muszą dokładnie odpowiadać odpowiednim wymiarom maski.

•wymagane mask_url
Upuść plik lub

Maska inpaintingu podana jako adres URL; jej szerokość i wysokość muszą dokładnie odpowiadać odpowiednim wymiarom obrazu wejściowego.

rendering_speed domyślnie BALANCED

Ustawienie szybkości renderowania.

num_images domyślnie 1

Liczba obrazów do wygenerowania.

Zaawansowane images · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
Upuść plik lub

Obrazy referencyjne stylu w formacie JPEG, PNG lub WebP. Ich łączny rozmiar nie może przekraczać 10 MB.

Ustawienie stylu sterujące generowaniem obrazu.

Wartość ziarna do generowania liczb losowych.

Kody stylu obrazu, podawane jako ciągi szesnastkowe po 8 znaków każdy; podczas używania tej listy pomiń zarówno style_reference_images, jak i style.

Paleta kolorów używana podczas generowania. Określ preset za pomocą name albo jawne kolory szesnastkowe za pomocą members, opcjonalnie z wagami.

POST /run/ideogram/v3/edit?wait=20 wycena → 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"

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o Ideogram V3 Edit

Wypełnia zamaskowany obszar obrazu zgodnie z `prompt`. Obraz (`image_url`) i maska (`mask_url`) muszą mieć identyczne wymiary. Styl można kształtować za pomocą obrazów referencyjnych, `style_codes`, `color_palette` lub `style_preset`. Prędkość renderowania to TURBO, BALANCED lub QUALITY, a wynik może zawierać od 1 do 8 obrazów.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
image_urlsopcjonalne images
Typurl[] · image
Obrazy referencyjne stylu w formacie JPEG, PNG lub WebP. Ich łączny rozmiar nie może przekraczać 10 MB.
rendering_speedopcjonalne
Typenum
DomyślneBALANCED
TURBOBALANCEDQUALITY
Ustawienie szybkości renderowania.
color_paletteopcjonalne
Typobject
Paleta kolorów używana podczas generowania. Określ preset za pomocą name albo jawne kolory szesnastkowe za pomocą members, opcjonalnie z wagami.
color_palette.membersopcjonalne
Typobject[]
Lista elementów palety definiująca jej kolory.
color_palette.members[].rgbwymagane
Typobject
Kolor elementu palety wyrażony jako RGB.
color_palette.members[].color_weightopcjonalne
Typnumber | null
Domyślne0.5
0,05 – 1
Waga przypisana temu kolorowi w palecie.
color_palette.nameopcjonalne
Typenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Wybór presetu palety kolorów.
style_codesopcjonalne
Typstring[]
Kody stylu obrazu, podawane jako ciągi szesnastkowe po 8 znaków każdy; podczas używania tej listy pomiń zarówno style_reference_images, jak i style.
expand_promptopcjonalne
Typboolean
Domyślnetrue
Przełącznik użycia MagicPrompt podczas generowania żądania.
num_imagesopcjonalne num_outputs
Typinteger
Domyślne1
1 – 8
Liczba obrazów do wygenerowania.
seedopcjonalne
Typinteger | null
Wartość ziarna do generowania liczb losowych.
style_presetopcjonalne
Typenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 więcejCOLORING_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
Ustawienie stylu sterujące generowaniem obrazu.
promptwymagane
Typstring
Prompt opisujący wypełnienie maskowanego obszaru obrazu.
image_urlwymagane image
Typurl · image
Źródło generowania podane jako adres URL obrazu; jego szerokość i wysokość muszą dokładnie odpowiadać odpowiednim wymiarom maski.
mask_urlwymagane mask
Typurl · image
Maska inpaintingu podana jako adres URL; jej szerokość i wysokość muszą dokładnie odpowiadać odpowiednim wymiarom obrazu wejściowego.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

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"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
images
array of object {url, content_type, file_name, file_size}
seed
integerWartość ziarna używana do generowania liczb losowych.

Więcej modeli: Edycja obrazów

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/ideogram/v3/edit.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt