שפּרינגען צו אינהאַלט

City Teleport

אינטעגרירן

מאָדעל־id image-apps-v2/city-teleport
# 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/image-apps-v2/city-teleport?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "person_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "city_name": "Paris"
  }'

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

דער דאָזיקער ריקוועסט: ⁨$ 0.04⁩ 40 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Utility בילד־עדיטירונג #city-teleport#backgroundswap

שטעלט אַ מענטש־פֿאָטאָ אין אַ געהייסענער שטאָט אָדער קאַסטאַמער־הינטערגרונט, מיט אָפּציעס פֿאַר שאָס־טיפּ און קאַמערע־ווינקל

Utility · בילד

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

•פארלאנגט
לייגט אַרײַן אַ טעקע, אָדער

URL פֿון אַ פֿאָטאָגראַפֿיע מיט דער פּערזאָן.

•פארלאנגט

שטאָט־נאָמען צו ניצן ווען city_image_url ווערט נישט צוגעשטעלט.

רעזולטאַט־אַספּעקט־פּראָפּאָרציע ביי 4K.

פֿאָרגעשריטן city_image_url · photo_shot · camera_angle · enable_safety_checker
לייגט אַרײַן אַ טעקע, אָדער

אייגענע שטאָט־סצענע אין וועלכער די פּערזאָן ווערט אַרײַנגעמישט, אָפּציאָנאַל צוגעשטעלט ווי באַקגראַונד־בילד־URL.

photo_shot סטאַנדאַרט medium_shot

פֿאָטאָגראַפֿישער שאָס־טיפּ.

camera_angle סטאַנדאַרט eye_level

קאַמערע־פּערספּעקטיוו געניצט פֿאַרן שאָס.

POST /run/image-apps-v2/city-teleport?wait=20 פּרײַז → ⁨$ 0.04⁩
# 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/image-apps-v2/city-teleport?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "person_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "city_name": "Paris"
  }'

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

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן City Teleport

דאַרף אַ מענטש־פֿאָטאָ (`person_image_url`) און אַ `city_name`. מען קען צושטעלן `city_image_url` צו מישן דעם מענטש אין אַן אייגענער סצענע. `photo_shot` האָט אַכט פֿריימינג־אָפּציעס פֿון עקסטרעמען נאָענט־שאָס ביזן גאַנצן קערפּער, און `camera_angle` האָט אַכט ברירות ווי נידעריקן ווינקל אָדער פֿייגל־פּערספּעקטיוו. `aspect_ratio` און `enable_safety_checker` זענען אויך בנימצא.

פּאַראַמעטערס

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
person_image_urlפארלאנגט
טיפּurl · image
URL פֿון אַ פֿאָטאָגראַפֿיע מיט דער פּערזאָן.
city_image_urlאָפּציאָנעל
טיפּurl · image
אייגענע שטאָט־סצענע אין וועלכער די פּערזאָן ווערט אַרײַנגעמישט, אָפּציאָנאַל צוגעשטעלט ווי באַקגראַונד־בילד־URL.
city_nameפארלאנגט
טיפּstring
שטאָט־נאָמען צו ניצן ווען city_image_url ווערט נישט צוגעשטעלט.
photo_shotאָפּציאָנעל
טיפּenum
סטאַנדאַרטmedium_shot
extreme_close_upclose_upmedium_close_upmedium_shotmedium_long_shotlong_shotextreme_long_shotfull_body
פֿאָטאָגראַפֿישער שאָס־טיפּ.
camera_angleאָפּציאָנעל
טיפּenum
סטאַנדאַרטeye_level
eye_levellow_anglehigh_angledutch_anglebirds_eye_viewworms_eye_viewoverheadside_angle
קאַמערע־פּערספּעקטיוו געניצט פֿאַרן שאָס.
aspect_ratioאָפּציאָנעל
טיפּobject
רעזולטאַט־אַספּעקט־פּראָפּאָרציע ביי 4K.
aspect_ratio.ratioאָפּציאָנעל
טיפּenum
סטאַנדאַרט1:1
1:116:99:164:33:4
רעזולטאַט־אַספּעקט־פּראָפּאָרציע ביי 4K רעזאָלוציע.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
סקרינינג קען ווערן פאַרלייכטערט דורך שטעלן false, אויב דער רופער איז אָטעריזירט.
פארלאנגט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם file_url פֿון אַן אַרויפֿלאָד. טעקעס

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "image-apps-v2/city-teleport",
  "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": 40,
    "usd": "0.04",
    "charged": 40,
    "refunded": 0
  },
  "input": {
    "person_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "city_name": "Paris"
  },
  "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
      }
    ]
  },
  "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"
  }
}
אייער טעקעס, אייער ברירהיעדער outputs[].url איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער GB־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
images
array of object {url, content_type, file_name, file_size, width, height}בילד וואָס ווײַזט די פּערזאָן אַריבערגעפֿירט אין דער שטאָט־סביבה.

מער מאָדעלן: בילד־עדיטירונג

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/image-apps-v2/city-teleport.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt