Мазмұнға өту

Phota

Интеграциялау

Модель идентификаторы phota/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/phota/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"

Осы сұрау: 0,09 $ 90 API кредиті Осы бетте іске қосу

API кілтін алу
Open model Кескінді өңдеу 4K шығысы4K дейін #edit#personalization#typography#phota

1-ден 10-ға дейін кіріс кескіні және қосымша оқытылған профильдері бар, тұлғаны сақтайтын фотосурет өңдеуі

Open model · Кескін

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

•міндетті 88 / 8000

[[profile_id_1]] және [[profile_id_2]] сияқты профиль сілтемелерін жасау сипаттамасымен қатар қамти алатын кескін генерациялау нұсқауы.

•міндетті image_urls
Файлды тастаңыз немесе

Өңделетін кескіндер URL немесе Base64 деректер URI ретінде беріледі; алғашқы 10-нан кейінгі жазбалар еленбейді. Кемінде бір кескін беріңіз немесе тек мәтіннен генерациялау үшін `/` соңғы нүктесін пайдаланыңыз.

resolution әдепкі 1K

Генерацияланған кескін үшін қолданылатын ажыратымдылық.

aspect_ratio әдепкі auto

Шығыс кескінінің ені мен биіктігінің арақатынасы.

num_images әдепкі 1

Жасалатын кескіндер саны.

Қосымша output_format · base_model · enable_safety_checker · profile_ids
output_format әдепкі jpeg

Нәтижедегі кескіннің файл пішімі.

base_model әдепкі nb2

Рендерлеу моделін таңдау; `4K` тек `nb2` арқылы қолжетімді. Identity қабаттары таңдалған негізгі модельдің үстіне қосылады, сондықтан барлық таңдау үйретілген профильдермен үйлесімді.

Кескін генерациясына арналған профильдер тізімі ретінде берілетін ID мәндері; нұсқау бұл профильдерді @Profile1, @Profile2 және тағы басқалары арқылы белгілей алады.

POST /run/phota/edit?wait=20 бағасы → 0,09 $
# 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/phota/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"

Осы сұрауды іске қосу

Кілтіңіз осы браузерде қалады: ол тек Doitong API-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Phota туралы

Ұзындығы 8000 таңбаға дейінгі `prompt` және кемінде бір кескін қажет ететін `image_urls` арқылы бар фотосуреттерді өңдейді; ең көбі 10 кескін пайдаланылады. Нақты адамдарды танылатын күйде сақтау үшін `profile_ids` беріңіз. `base_model` nb2, qwen-image-2, flux-2 немесе seedream-5-pro болуы мүмкін, ал 4K шығыс тек nb2 жүйесінде жұмыс істейді. JPEG немесе PNG форматында 1-ден 4-ке дейін кескін қайтарады.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
promptміндетті
Түріstring
≤ 8 000 таңба
[[profile_id_1]] және [[profile_id_2]] сияқты профиль сілтемелерін жасау сипаттамасымен қатар қамти алатын кескін генерациялау нұсқауы.
num_imagesміндетті емес num_outputs
Түріinteger
Әдепкі1
1 – 4
Жасалатын кескіндер саны.
profile_idsміндетті емес
Түріstring[]
Кескін генерациясына арналған профильдер тізімі ретінде берілетін ID мәндері; нұсқау бұл профильдерді @Profile1, @Profile2 және тағы басқалары арқылы белгілей алады.
output_formatміндетті емес
Түріenum
Әдепкіjpeg
jpegpng
Нәтижедегі кескіннің файл пішімі.
resolutionміндетті емес
Түріenum
Әдепкі1K
1K4K
Генерацияланған кескін үшін қолданылатын ажыратымдылық.
aspect_ratioміндетті емес
Түріenum
Әдепкіauto
auto1:116:94:33:49:16
Шығыс кескінінің ені мен биіктігінің арақатынасы.
base_modelміндетті емес
Түріenum
Әдепкіnb2
nb2qwen-image-2flux-2seedream-5-pro
Рендерлеу моделін таңдау; `4K` тек `nb2` арқылы қолжетімді. Identity қабаттары таңдалған негізгі модельдің үстіне қосылады, сондықтан барлық таңдау үйретілген профильдермен үйлесімді.
image_urlsміндетті images
Түріurl[] · image
Өңделетін кескіндер URL немесе Base64 деректер URI ретінде беріледі; алғашқы 10-нан кейінгі жазбалар еленбейді. Кемінде бір кескін беріңіз немесе тек мәтіннен генерациялау үшін `/` соңғы нүктесін пайдаланыңыз.
enable_safety_checkerміндетті емес
Түріboolean
Әдепкіtrue
Шақырушы авторизацияланған болса, false мәнін орнату арқылы тексеруді жеңілдетуге болады.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың file_url мәнін қабылдайды. Файлдар

Шығыс

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "phota/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": 90,
    "usd": "0.09",
    "charged": 90,
    "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
      }
    ]
  },
  "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-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
images
array of object {url, content_type, file_name, file_size, width, height}Өңделген кескінге сілтейтін URL.

Қосымша модельдер: Кескінді өңдеу

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/phota/edit.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt