Op den Inhalt sprangen

Hunyuan Image · v3 · Instruct · Edit

Integréieren

Modell-ID hunyuan-image/v3/instruct/edit
# 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/hunyuan-image/v3/instruct/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",
    "images": [
      "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"

Dës Ufro: ≈0,174 $ 174 API-Kreditter Op dëser Säit ausféieren

API-Schlëssel kréien
Tencent Bildbearbechtung #tencent#hunyuan-image#instruct#edit

Instruktiounsbaséiert Bildbearbechtung aus bis zu 3 Referenzbiller, mat fakultativer Prompt-Erweiderung

Tencent · Bild

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

•obligatoresch

Textinstruktioune fir e Bild ze generéieren.

•obligatoresch image_urls
Fichier erofzéien, oder

Generatiounsreferenzen iwwer URLen ugi, mat héchstens 3 Biller an der Lëscht.

image_size Standard auto

Dimensioune vum Output-Bild, entweder explizit ugefrot oder vum Modell gewielt, wann auto agestallt ass.

num_images Standard 1

Ugefrote Bildzuel fir d'Generatioun.

Erweidert output_format · guidance_scale · seed · enable_prompt_expansion · enable_safety_checker
output_format Standard png

Dateiformat vum resultéierende Bild.

Standard 3.5

Stäerkt vun der Prompt-Befollegung: erhéicht dëse Wäert, fir datt d'Modell dem Prompt méi streng follegt.

Seed fir Reproduzéierbarkeet; None léisst de System zoufälleg een auswielen, amplaz e vum Uruffer spezifizéierte Wäert ze benotzen.

POST /run/hunyuan-image/v3/instruct/edit?wait=20 Präis → 0,174 $
# 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/hunyuan-image/v3/instruct/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",
    "images": [
      "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"

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

Iwwer Hunyuan Image · v3 · Instruct · Edit

Biller ginn no engem Text-`prompt` geännert, mat engem bis dräi Referenzbiller an `image_urls`. `image_size` ass par défaut auto, sou datt de Modell d’Ausgabgréisst wielt. Bis zu 4 Biller kënnen zeréckgi ginn, `guidance_scale` leeft vun 1 bis 20, an d’Prompt-Erweiderung ass par défaut aktiv. D’Ausgab ass png oder jpeg.

Parameteren

Schéck entweder den kanoneschen Numm oder den natierlechen Numm, net béid. Kanonesch Nimm

NummTyp StandardErlaabt Beschreiwung
promptobligatoresch
Typstring
Textinstruktioune fir e Bild ze generéieren.
image_sizeoptional
Typobject
Standardauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensioune vum Output-Bild, entweder explizit ugefrot oder vum Modell gewielt, wann auto agestallt ass.
num_imagesoptional num_outputs
Typinteger
Standard1
1 – 4
Ugefrote Bildzuel fir d'Generatioun.
guidance_scaleoptional
Typnumber
Standard3.5
≤ 20> 1
Stäerkt vun der Prompt-Befollegung: erhéicht dëse Wäert, fir datt d'Modell dem Prompt méi streng follegt.
enable_prompt_expansionoptional
Typboolean
Standardtrue
Prompt-Erweiderung duerch intern Recaptioning vum Modell, aktivéiert wann true agestallt ass.
seedoptional
Typinteger | null
Seed fir Reproduzéierbarkeet; None léisst de System zoufälleg een auswielen, amplaz e vum Uruffer spezifizéierte Wäert ze benotzen.
enable_safety_checkeroptional
Typboolean
Standardtrue
Aktivéierung vun der Sécherheetskontroll; true aktivéiert d'Kontroll.
output_formatoptional
Typenum
Standardpng
jpegpng
Dateiformat vum resultéierende Bild.
image_urlsobligatoresch images
Typurl[] · image
Generatiounsreferenzen iwwer URLen ugi, mat héchstens 3 Biller an der Lëscht.
obligatoresch Kanoneschen Numm, och akzeptéiert

Fichierparameter akzeptéieren eng ëffentlech https:// URL, eng data: URI bis zu 10 MB oder de file_url vun engem Upload. Fichieren

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-image/v3/instruct/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": 174,
    "usd": "0.174",
    "charged": 174,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "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
      }
    ],
    "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
images
array of object {url, content_type, file_name, file_size, width, height}Lëscht mat de generéierte Biller.
seed
integerBasis-Seed, dee bei der Generatioun benotzt gëtt.

Méi Modeller: Bildbearbechtung

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/hunyuan-image/v3/instruct/edit.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt