Hunyuan Image · v3 · Instruct · Edit

Unganisha

Kitambulisho cha modeli 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"

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/hunyuan-image/v3/instruct/edit?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "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"
    ]
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "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",
    ],
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/hunyuan-image/v3/instruct/edit", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/sw/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "hunyuan-image/v3/instruct/edit",
  "input": {
    "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"
    ]
  }
}

Piga modeli ya Hunyuan Image · v3 · Instruct · Edit (hunyuan-image/v3/instruct/edit) kupitia Doitong API. Nyaraka za mawakala: https://doitong.com/sw/developers/models/hunyuan-image/v3/instruct/edit.md

POST https://api.doitong.com/v1/run/hunyuan-image/v3/instruct/edit?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "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"
  ]
}

Ikiwa hali ya jibu ni "queued" au "running", piga GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 mara kwa mara hadi iwe "succeeded"; faili ziko kwenye outputs[].url. POST https://api.doitong.com/v1/quote/hunyuan-image/v3/instruct/edit yenye mwili uleule hurejesha bei kamili kabla ya kuendesha.

Ombi hili: ≈$ 0.174 salio za API 174 Iendeshe kwenye ukurasa huu

Pata ufunguo wa API

Tencent Uhariri wa Picha #tencent#hunyuan-image#instruct#edit

Uhariri wa picha unaotegemea maagizo kutoka kwa hadi picha 3 za marejeo, ikiwa na upanuzi wa hiari wa kidokezo

OpenAPI Markdown

Tencent · Picha

Tokeo lako la kwanza linaonekana hapa

Unda ombi hapa chini na uliendeshe kwa ufunguo wako wa API. Matokeo yanakiliwa kwenye hifadhi yetu, yakihifadhiwa milele au 7 siku bila malipo.

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

prompt •inahitajika

Maelekezo ya maandishi yanayotumika kuzalisha picha.

images •inahitajika image_urls

Dondosha faili, au

Toa marejeleo ya uzalishaji kupitia URL, zikiwa na picha zisizozidi 3 kwenye orodha.

image_size chaguomsingi auto

Vipimo vya picha ya tokeo, vilivyoombwa wazi au kuchaguliwa na modeli ikiwa vimewekwa kuwa auto.

num_outputs num_images chaguomsingi 1

Idadi ya picha iliyoombwa kwa uzalishaji.

Ya kina output_format · guidance_scale · seed · enable_prompt_expansion · enable_safety_checker

output_format chaguomsingi png

Muundo wa faili wa picha inayotokana.

guidance_scale chaguomsingi 3.5

Nguvu ya kufuata kidokezo: ongeza thamani hii ili kufanya modeli ifuate kidokezo kwa ukali zaidi.

seed

Mbegu ya uzalishwaji tena; None huruhusu mfumo kuchagua moja kwa nasibu badala ya kutumia thamani iliyobainishwa na mpigaji wa ombi.

POST /run/hunyuan-image/v3/instruct/edit?wait=20 makadirio → $ 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"

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/hunyuan-image/v3/instruct/edit?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "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"
    ]
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "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",
    ],
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/hunyuan-image/v3/instruct/edit", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "hunyuan-image/v3/instruct/edit",
      "input": {
        "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"
        ]
      },
      "wait_seconds": 20
    }
  }
}

Endesha ombi hili

Ufunguo wa API

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Kumbuka katika kivinjari hiki Pata ufunguo wa API

Kuhusu Hunyuan Image · v3 · Instruct · Edit

Hubadilisha picha kwa kufuata `prompt` ya maandishi, kwa kutumia picha moja hadi tatu za marejeo katika `image_urls`. `image_size` ni auto kwa chaguomsingi, hivyo modeli huchagua ukubwa wa tokeo. Hadi picha 4 zinaweza kurudishwa, `guidance_scale` huanzia 1 hadi 20, na upanuzi wa kidokezo huwashwa kwa chaguomsingi. Tokeo ni png au jpeg.

Vigezo

Tuma jina rasmi au jina asilia, si yote mawili. Majina rasmi

JinaAina ChaguomsingiInaruhusiwa Maelezo

promptinahitajika

Ainastring

Maelekezo ya maandishi yanayotumika kuzalisha picha.

image_sizesi lazima

Ainaobject

Chaguomsingiauto

autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9

Vipimo vya picha ya tokeo, vilivyoombwa wazi au kuchaguliwa na modeli ikiwa vimewekwa kuwa auto.

num_imagessi lazima num_outputs

Ainainteger

Chaguomsingi1

1 – 4

Idadi ya picha iliyoombwa kwa uzalishaji.

guidance_scalesi lazima

Ainanumber

Chaguomsingi3.5

≤ 20> 1

Nguvu ya kufuata kidokezo: ongeza thamani hii ili kufanya modeli ifuate kidokezo kwa ukali zaidi.

enable_prompt_expansionsi lazima

Ainaboolean

Chaguomsingitrue

Upanuzi wa kidokezo kupitia uundaji upya wa maelezo na modeli ya ndani, unaowashwa ukiwekwa kuwa true.

seedsi lazima

Ainainteger | null

Mbegu ya uzalishwaji tena; None huruhusu mfumo kuchagua moja kwa nasibu badala ya kutumia thamani iliyobainishwa na mpigaji wa ombi.

enable_safety_checkersi lazima

Ainaboolean

Chaguomsingitrue

Uanzishaji wa kikagua usalama; true huanzisha ukaguzi.

output_formatsi lazima

Ainaenum

Chaguomsingipng

jpegpng

Muundo wa faili wa picha inayotokana.

image_urlsinahitajika images

Ainaurl[] · image

Toa marejeleo ya uzalishaji kupitia URL, zikiwa na picha zisizozidi 3 kwenye orodha.

inahitajika Jina rasmi, pia linakubalika

Vigezo vya faili vinakubali URL ya umma ya https://, data: URI ya hadi 10 MB, au file_url ya upakiaji. Faili

Tokeo

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"
  }
}

Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.

Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.

Sehemu za tokeo

images: array of object {url, content_type, file_name, file_size, width, height}Orodha iliyo na picha zilizozalishwa.
seed: integerMbegu msingi iliyotumika wakati wa uzalishaji.

Miundo zaidi: Uhariri wa Picha

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/hunyuan-image/v3/instruct/edit.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt

Tokeo lako la kwanza linaonekana hapa

Unda ombi

Endesha ombi hili

Kuhusu Hunyuan Image · v3 · Instruct · Edit

Vigezo

Tokeo

Tofauti nyingine za Hunyuan Image

Hunyuan Image 3.0 Instruct Tofauti: 2

Miundo zaidi: Uhariri wa Picha

FLUX.1 Kontext [pro] Tofauti: 7

GPT Image 2.5 Edit Tofauti: 4

Nano Banana 2 Edit Tofauti: 2

Nano Banana Pro Edit Tofauti: 2