Saltar al cuntegna

Hunyuan World · Image to World

Integrar

ID dal model hunyuan_world/image-to-world
# 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/hunyuan_world/image-to-world?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "labels_fg1": "tree, grass, sky",
    "labels_fg2": "mountain, water",
    "classes": "nature, landscape"
  }'

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

Questa dumonda: $0,30 300 credits API · ≈ ₽32,27 Lantschar sin questa pagina

Obtegna ina clav API
Tencent · Datas (JSON)

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 image_url
Trametta in datoteca u

URL dal maletg da funtauna per la conversiun en in mund.

•obligatori

Etichettas assegnadas al prim object en il foreground.

•obligatori

Etichettas assegnadas al segund object en il foreground.

•obligatori

Classas utilisadas per generar il mund.

Avanzà export_drc · enable_safety_checker
POST /run/hunyuan_world/image-to-world?wait=20 calculaziun → $0,30
# 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/hunyuan_world/image-to-world?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "labels_fg1": "tree, grass, sky",
    "labels_fg2": "mountain, water",
    "classes": "nature, landscape"
  }'

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

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 Hunyuan World · Image to World

Construeix un món 3D a partir de `image_url`. Requereix `labels_fg1` i `labels_fg2` per als dos objectes del primer pla, i `classes` per a la generació. `export_drc` és opcional i està desactivat per defecte. Retorna un fitxer de món com a sortida de tipus JSON.

Parameters

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

NumTip StandardPermess Descripziun
image_urlobligatori image
Tipurl · image
URL dal maletg da funtauna per la conversiun en in mund.
labels_fg1obligatori
Tipstring
Etichettas assegnadas al prim object en il foreground.
labels_fg2obligatori
Tipstring
Etichettas assegnadas al segund object en il foreground.
classesobligatori
Tipstring
Classas utilisadas per generar il mund.
export_drcopziunal
Tipboolean
Standardfalse
Controlla l'export da DRC (Dynamic Resource Configuration).
enable_safety_checkeropziunal
Tipboolean
Standardtrue
La controlla po vegnir schluccada cun definir false, premess che l'appelant saja autorisà.
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": "hunyuan_world/image-to-world",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "labels_fg1": "tree, grass, sky",
    "labels_fg2": "mountain, water",
    "classes": "nature, landscape"
  },
  "output": {
    "world_file": {
      "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
    }
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "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"
  }
}
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
world_file
object {url, content_type, file_name, file_size}Mund producì tras generaziun.

Dapli models: Maletg a 3D

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