Saltar al cuntegna

Ideogram V4.0q Image to Image

Integrar

ID dal model ideogram/v4/image-to-image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ideogram/v4/image-to-image?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"
  }'

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

Datotecas sco l'exempel: $0,015 15 credits API tias datotecas vegnan mesiradas avant l'execuziun Lantschar sin questa pagina

Obtegna ina clav API
Ideogram Modificaziun da maletgs #realism#typography#stylized

Restilizaziun V4 da maletg a maletg che mantegna la structura, cun adattaziun automatica da la grondezza e controlla da la fermezza

Ideogram · Maletg

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori

Prompt che gida la generaziun dal maletg.

•obligatori image_url
Trametta in datoteca u

URL dal maletg da funtauna utilisà per la generaziun maletg-a-maletg.

image_size standard auto

Definescha las dimensiuns da l'output u tscherna 'auto' per mantegnair las dimensiuns da l'input entaifer quests limits: circa 25MP en total e maximalmain 8192px sin mintga vart.

rendering_speed standard BALANCED

Configuraziun da la sveltezza da renderisaziun; las opziuns pli sveltas fan main pass da denoisaziun.

num_images standard 1

Dumber da maletgs da producir.

Avanzà expansion_model · acceleration · output_format · strength · seed · enable_safety_checker
expansion_model standard Medium

Tscherna il model d'engrandiment dal prompt: 'Large' porscha la pli auta qualitad cun Magic Prompt da Ideogram, entant che 'Medium' prioritisescha la sveltezza. Tscherna 'None' per laschar il prompt senza engrandiment.

acceleration standard none

Configuraziun d'acceleraziun per generar maletgs.

output_format standard jpeg

Format da datoteca dal maletg final.

standard 0.8

Grad da transfurmaziun dal maletg: valurs pli pitschnas mantegnan il resultat pli datiers da la funtauna, entant che tar 1.0 la funtauna n'ha nagina influenza.

Semenza per la generaziun, tschernida casualmain sche ti na furneschas nagina valur.

POST /run/ideogram/v4/image-to-image?wait=20 calculaziun → $0,015
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ideogram/v4/image-to-image?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"
  }'

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

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Ideogram V4.0q Image to Image

Transformescha in maletg d'entrada (`image_url`) cun in `prompt`. `strength` tanscha da 0 a 1 (default 0.8), nua che 1.0 ignora l'entrada. `image_size` è per default auto e s'adatta al maletg da partenza. Porscha era `expansion_model`, `rendering_speed`, `acceleration`, 1 fin a 4 outputs e il format JPEG u PNG.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
promptobligatori
Tipstring
Prompt che gida la generaziun dal maletg.
expansion_modelopziunal
Tipenum
StandardMedium
NoneMediumLarge
Tscherna il model d'engrandiment dal prompt: 'Large' porscha la pli auta qualitad cun Magic Prompt da Ideogram, entant che 'Medium' prioritisescha la sveltezza. Tscherna 'None' per laschar il prompt senza engrandiment.
image_sizeopziunal
Tipobject
Standardauto
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
Definescha las dimensiuns da l'output u tscherna 'auto' per mantegnair las dimensiuns da l'input entaifer quests limits: circa 25MP en total e maximalmain 8192px sin mintga vart.
rendering_speedopziunal
Tipenum
StandardBALANCED
TURBOBALANCEDQUALITY
Configuraziun da la sveltezza da renderisaziun; las opziuns pli sveltas fan main pass da denoisaziun.
accelerationopziunal
Tipenum
Standardnone
nonelowregularhigh
Configuraziun d'acceleraziun per generar maletgs.
num_imagesopziunal num_outputs
Tipinteger
Standard1
1 – 4
Dumber da maletgs da producir.
seedopziunal
Tipinteger | null
Semenza per la generaziun, tschernida casualmain sche ti na furneschas nagina valur.
enable_safety_checkeropziunal
Tipboolean
Standardtrue
Interrutur da controlla da segirezza, dal qual la configuraziun spustada pretenda l'autorisaziun dal conto. Senza questa autorisaziun vegn mintga dumonda controllada independentamain da la configuraziun; true activa il controllader.
output_formatopziunal
Tipenum
Standardjpeg
jpegpng
Format da datoteca dal maletg final.
image_urlobligatori image
Tipurl · image
URL dal maletg da funtauna utilisà per la generaziun maletg-a-maletg.
strengthopziunal
Tipnumber
Standard0.8
0 – 1
Grad da transfurmaziun dal maletg: valurs pli pitschnas mantegnan il resultat pli datiers da la funtauna, entant che tar 1.0 la funtauna n'ha nagina influenza.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v4/image-to-image",
  "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": 15,
    "usd": "0.015",
    "charged": 15,
    "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"
  },
  "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,
        "width": 1024,
        "height": 768
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
images
array of object {url, content_type, file_name, file_size, width, height}Maletgs producids dal model.
timings
object
seed
integerSeed da la generaziun dal maletg, inclusa la valur tschernida casualmain sche l'input n'ha betg furnì in seed; autramain repeta la valur furnida.
has_nsfw_concepts
array of booleanInditgescha sche concepts NSFW cumparan en ils maletgs generads.
prompt
stringPrompt utilisà durant la generaziun dal maletg.

Dapli models: Modificaziun da maletgs

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/ideogram/v4/image-to-image.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt