Live Portrait · Image

Unganisha

Kitambulisho cha modeli live-portrait/image

# 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/live-portrait/image?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"
  }'

# 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/live-portrait/image?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "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 = {
    "image": "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/live-portrait/image", 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": "live-portrait/image",
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }
}

Piga modeli ya Live Portrait · Image (live-portrait/image) kupitia Doitong API. Nyaraka za mawakala: https://doitong.com/sw/developers/models/live-portrait/image.md

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

{
  "image": "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/live-portrait/image yenye mwili uleule hurejesha bei kamili kabla ya kuendesha.

Hadi $ 1.125 kwa kila uendeshaji hutozwa kulingana na matumizi halisi, yaliyosalia yanarejeshwa Iendeshe kwenye ukurasa huu

Pata ufunguo wa API

Kuaishou Uhariri wa Picha #expression#animation

Huhariri mwonekano na mkao wa kichwa wa portrait moja kwa kutumia vitelezi, na kutoa picha tuli

OpenAPI Markdown

Kuaishou · 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.

image •inahitajika image_url

Dondosha faili, au

URL ya picha kwa uhuishaji.

Ya kina output_format · blink · eyebrow · wink · pupil_x · pupil_y · aaa · eee · woo · smile · rotate_pitch · rotate_yaw · rotate_roll · dsize · scale · vx_ratio · vy_ratio · flag_pasteback · flag_do_crop · flag_do_rot · flag_lip_zero · enable_safety_checker

output_format chaguomsingi jpeg

Muundo unaotumika kwa tokeo.

blink chaguomsingi 0

Kiwango cha kupepesa macho.

eyebrow chaguomsingi 0

Kiwango cha kuinua au kushusha nyusi.

wink chaguomsingi 0

Kiwango cha kukonyeza.

pupil_x chaguomsingi 0

Kiasi cha mwendo wa mboni mlalo.

pupil_y chaguomsingi 0

Kiasi cha mwendo wa mboni wima.

aaa chaguomsingi 0

Kiwango cha kufungua mdomo katika umbo la 'aaa'.

eee chaguomsingi 0

Kiwango cha kuunda mdomo katika mkao wa 'eee'.

woo chaguomsingi 0

Kiwango cha kuunda mdomo katika mkao wa 'woo'.

smile chaguomsingi 0

Kiwango cha kutabasamu.

rotate_pitch chaguomsingi 0

Kiasi cha mzunguko wa uso kwenye mhimili wa pitch.

rotate_yaw chaguomsingi 0

Kiasi cha mzunguko wa uso kwenye mhimili wa yaw.

rotate_roll chaguomsingi 0

Kiasi cha mzunguko wa uso kwenye mhimili wa roll.

dsize chaguomsingi 512

Vipimo vya picha inayotokana.

scale chaguomsingi 2.3

Kizidishi cha kipimo kinachotumika kwa kipande cha uso.

vx_ratio chaguomsingi 0

Uwiano unaodhibiti uhamisho wa mlalo wa kipande cha uso.

vy_ratio chaguomsingi -0.125

Uwiano wa uwekaji wa wima wa kipande cha uso: ishara huamua mwelekeo, juu kwa thamani chanya na chini kwa thamani hasi.

POST /run/live-portrait/image?wait=20 makadirio → $ 1.125

# 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/live-portrait/image?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"
  }'

# 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/live-portrait/image?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "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 = {
    "image": "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/live-portrait/image", 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": "live-portrait/image",
      "input": {
        "image": "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 Live Portrait · Image

Hurekebisha uso katika picha moja ya portrait bila video ya uendeshaji. Vitelezi hudhibiti kupepesa, nyusi, kukonyeza, nafasi ya mboni, maumbo ya mdomo (aaa, eee, woo), tabasamu na mzunguko wa kichwa (pitch, yaw, roll). Chaguo za kupunguza kama `flag_do_crop` na `scale`, pamoja na `dsize` (chaguomsingi 512), hudhibiti upunguzaji wa uso. Matokeo ni jpeg kwa chaguomsingi, au png.

Vigezo

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

JinaAina ChaguomsingiInaruhusiwa Maelezo

image_urlinahitajika image

Ainaurl · image

URL ya picha kwa uhuishaji.

blinksi lazima

Ainanumber

Chaguomsingi0

-30 – 30

Kiwango cha kupepesa macho.

eyebrowsi lazima

Ainanumber

Chaguomsingi0

-30 – 30

Kiwango cha kuinua au kushusha nyusi.

winksi lazima

Ainanumber

Chaguomsingi0

0 – 25

Kiwango cha kukonyeza.

pupil_xsi lazima

Ainanumber

Chaguomsingi0

-45 – 45

Kiasi cha mwendo wa mboni mlalo.

pupil_ysi lazima

Ainanumber

Chaguomsingi0

-45 – 45

Kiasi cha mwendo wa mboni wima.

aaasi lazima

Ainanumber

Chaguomsingi0

-200 – 200

Kiwango cha kufungua mdomo katika umbo la 'aaa'.

eeesi lazima

Ainanumber

Chaguomsingi0

-40 – 40

Kiwango cha kuunda mdomo katika mkao wa 'eee'.

woosi lazima

Ainanumber

Chaguomsingi0

-100 – 100

Kiwango cha kuunda mdomo katika mkao wa 'woo'.

smilesi lazima

Ainanumber

Chaguomsingi0

-2 – 2

Kiwango cha kutabasamu.

rotate_pitchsi lazima

Ainanumber

Chaguomsingi0

-45 – 45

Kiasi cha mzunguko wa uso kwenye mhimili wa pitch.

rotate_yawsi lazima

Ainanumber

Chaguomsingi0

-45 – 45

Kiasi cha mzunguko wa uso kwenye mhimili wa yaw.

rotate_rollsi lazima

Ainanumber

Chaguomsingi0

-45 – 45

Kiasi cha mzunguko wa uso kwenye mhimili wa roll.

flag_pastebacksi lazima

Ainaboolean

Chaguomsingitrue

Chaguo la kubandika/kushona nyuma linaloweka kipande cha uso kilichohuishwa kwenye picha asili, kikikiondoa katika viwianishi vya kipande cha uso.

flag_do_cropsi lazima

Ainaboolean

Chaguomsingitrue

Hudhibiti ikiwa picha ya chanzo itakatwa katika nafasi ya viwianishi vya kipande cha uso.

flag_do_rotsi lazima

Ainaboolean

Chaguomsingitrue

Hudhibiti ikiwa mzunguko utafanywa wakati flag_do_crop ni true.

flag_lip_zerosi lazima

Ainaboolean

Chaguomsingitrue

Kufunga midomo kabla ya uhuishaji, kunakotumika tu wakati flag_eye_retargeting na flag_lip_retargeting zote zimewekwa kuwa False.

dsizesi lazima

Ainainteger

Chaguomsingi512

Vipimo vya picha inayotokana.

scalesi lazima

Ainanumber

Chaguomsingi2.3

Kizidishi cha kipimo kinachotumika kwa kipande cha uso.

vx_ratiosi lazima

Ainanumber

Chaguomsingi0

Uwiano unaodhibiti uhamisho wa mlalo wa kipande cha uso.

vy_ratiosi lazima

Ainanumber

Chaguomsingi-0.125

Uwiano wa uwekaji wa wima wa kipande cha uso: ishara huamua mwelekeo, juu kwa thamani chanya na chini kwa thamani hasi.

enable_safety_checkersi lazima

Ainaboolean

Chaguomsingifalse

Hudhibiti ikiwa ukaguzi wa usalama umewezeshwa. Ukiwa amilifu, kikagua huchakata picha ya ingizo ili kuthibitisha kuwa ina uso kabla ya uchakataji wa modeli.

output_formatsi lazima

Ainaenum

Chaguomsingijpeg

jpegpng

Muundo unaotumika kwa tokeo.

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": "live-portrait/image",
  "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": 1125,
    "usd": "1.125",
    "charged": 1125,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "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"
  }
}

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