ACE Step Audio Inpaint

Unganisha

Kitambulisho cha modeli ace-step/audio-inpaint

# 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/ace-step/audio-inpaint?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "tags": "lofi, hiphop, drum and bass, trap, chill"
  }'

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

const API = "https://api.doitong.ru/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/ace-step/audio-inpaint?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "tags": "lofi, hiphop, drum and bass, trap, chill"
  }),
});
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.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "tags": "lofi, hiphop, drum and bass, trap, chill",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/ace-step/audio-inpaint", 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.ru/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "ace-step/audio-inpaint",
  "input": {
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "tags": "lofi, hiphop, drum and bass, trap, chill"
  }
}

Piga modeli ya ACE Step Audio Inpaint (ace-step/audio-inpaint) kupitia Doitong API. Nyaraka za mawakala: https://doitong.com/sw/developers/models/ace-step/audio-inpaint.md

POST https://api.doitong.ru/v1/run/ace-step/audio-inpaint?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
  "tags": "lofi, hiphop, drum and bass, trap, chill"
}

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

Faili kama mfano: $ 0.002 salio za API 2 · ≈ ₽ 0.21 faili zako hupimwa kabla ya kuendesha Iendeshe kwenye ukurasa huu

Pata ufunguo wa API

ACE Studio Maandishi hadi Muziki #audio-to-audio#audio-inpaint#audio-repaint

Huzalisha upya muda uliochaguliwa wa faili ya sauti iliyopo kwa kutumia lebo na mashairi mapya

OpenAPI Markdown

ACE Studio · Sauti

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

Bei kwa kila sekunde ya sauti yako ya kuingiza

Bei kulingana na uingizaji wako

$ 0.0002 / sekunde ya sauti ya ingizo

salio za API 0.2 / sekunde ya sauti ya ingizo · ≈ ₽ 0.02

Ombi hili: sekunde 10 × $ 0.0002 $ 0.002 salio za API 2 · ≈ ₽ 0.21

Endesha · $ 0.002

Hutozwa tu ikifanikiwa, na kurejeshewa kiotomatiki ikishindwa.

Faili zako za kuingiza

audio_url

Urefu, s

Kikokotoo hutumia nambari hizi. POST /quote/ace-step/audio-inpaint hupima faili zako halisi na kurejesha bei kamili.

Faili zako hupimwa kabla ya kuendeshwa (urefu, mwonekano, kasi ya fremu); makadirio hurejesha bei kamili na uendeshaji hutozwa kiasi hicho hicho.

Endpoint ya makadirio: POST /quote/{id}

Unda ombi

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

audio •inahitajika audio_url

Dondosha faili, au

URL ya faili ya sauti kwa inpainting.

tags •inahitajika

Lebo za mtindo wa sauti zinazotolewa kama aina zilizotenganishwa kwa koma, huku `prompt` ikiwa njia mbadala ya kuzitoa.

Ya kina lyrics · start_time_relative_to · end_time_relative_to · scheduler · guidance_type · start_time · end_time · variance · number_of_steps · granularity_scale · guidance_interval · guidance_interval_decay · guidance_scale · minimum_guidance_scale · tag_guidance_scale · lyric_guidance_scale · seed

lyrics chaguomsingi

Maneno ya wimbo yanayoimbwa, huku sehemu za wimbo zikipangwa kwa kutumia vidhibiti kama [verse], [chorus], na [bridge]. Kwa sauti isiyo na maneno ya kuimbwa, acha ingizo hili au toa [inst] au [instrumental] pekee.

start_time_relative_to chaguomsingi start

Sehemu ya marejeleo ya muda wa kuanza: mwanzo au mwisho wa sauti.

end_time_relative_to chaguomsingi start

Sehemu ya marejeleo ya muda wa kumaliza: mwanzo au mwisho wa sauti.

scheduler chaguomsingi euler

Kiratibu kinachotumika wakati wa uzalishaji.

guidance_type chaguomsingi apg

Aina ya CFG inayotumika wakati wa uzalishaji.

start_time chaguomsingi 0

Muda wa kuanza inpainting, unaopimwa kwa sekunde.

end_time chaguomsingi 30

Muda wa kumaliza inpainting, unaopimwa kwa sekunde.

variance chaguomsingi 0.5

Variance ya inpainting hudhibiti jinsi matokeo yanavyoweza kuwa tofauti; kuiongeza kunaweza kuleta utofauti zaidi.

number_of_steps chaguomsingi 27

Idadi ya hatua zinazotumika wakati wa uzalishaji wa sauti.

granularity_scale chaguomsingi 10

Kiwango cha granularity kinachotumika wakati wa uzalishaji. Kukiongeza kunaweza kupunguza kasoro.

guidance_interval chaguomsingi 0.5

Sehemu ya ratiba ya uzalishaji inayopokea mwongozo: kuchagua 0.5 huiwekea mipaka hatua kutoka 0.25 * infer_steps hadi 0.75 * infer_steps, na kuacha mwanzo na mwisho bila mwongozo.

guidance_interval_decay chaguomsingi 0

Kupungua kwa mwongozo ndani ya muda wa uzalishaji: 0.0 huacha kupungua kikiwa kimezimwa; vinginevyo, kiwango hupungua katika muda huo kutoka guidance_scale hadi min_guidance_scale.

guidance_scale chaguomsingi 15

Kiwango cha mwongozo kinachotumika wakati wa uzalishaji.

minimum_guidance_scale chaguomsingi 3

Kiwango cha chini kabisa cha mwongozo kinachofikiwa baada ya kupungua wakati wa uzalishaji.

tag_guidance_scale chaguomsingi 5

Kiwango cha mwongozo wa lebo kinachotumika wakati wa uzalishaji.

lyric_guidance_scale chaguomsingi 1.5

Kiwango cha mwongozo wa maneno ya wimbo kinachotumika wakati wa uzalishaji.

seed

Seed ya uzalishaji unaoweza kurudiwa; huchaguliwa bila mpangilio isipokuwa utoe thamani.

POST /run/ace-step/audio-inpaint?wait=20 makadirio → $ 0.002

# 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/ace-step/audio-inpaint?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "tags": "lofi, hiphop, drum and bass, trap, chill"
  }'

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

const API = "https://api.doitong.ru/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/ace-step/audio-inpaint?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "tags": "lofi, hiphop, drum and bass, trap, chill"
  }),
});
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.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "tags": "lofi, hiphop, drum and bass, trap, chill",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/ace-step/audio-inpaint", 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": "ace-step/audio-inpaint",
      "input": {
        "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
        "tags": "lofi, hiphop, drum and bass, trap, chill"
      },
      "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 ACE Step Audio Inpaint

Hupokea `audio_url` na kuandika upya sehemu iliyo kati ya `start_time` na `end_time`, kila moja ikipimwa kwa sekunde kutoka 0 hadi 240. Kila muda unaweza kuwekwa kulingana na mwanzo au mwisho wa klipu. `tags` na `lyrics` mpya huongoza sehemu iliyobadilishwa, na `variance` hudhibiti utofauti wa matokeo. Miongozo ya kawaida na mipangilio ya hatua inapatikana.

Vigezo

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

JinaAina ChaguomsingiInaruhusiwa Maelezo

audio_urlinahitajika audio

Ainaurl · audio

URL ya faili ya sauti kwa inpainting.

start_time_relative_tosi lazima

Ainaenum

Chaguomsingistart

startend

Sehemu ya marejeleo ya muda wa kuanza: mwanzo au mwisho wa sauti.

start_timesi lazima

Ainanumber

Chaguomsingi0

0 – 240

Muda wa kuanza inpainting, unaopimwa kwa sekunde.

end_time_relative_tosi lazima

Ainaenum

Chaguomsingistart

startend

Sehemu ya marejeleo ya muda wa kumaliza: mwanzo au mwisho wa sauti.

end_timesi lazima

Ainanumber

Chaguomsingi30

0 – 240

Muda wa kumaliza inpainting, unaopimwa kwa sekunde.

tagsinahitajika

Ainastring

Lebo za mtindo wa sauti zinazotolewa kama aina zilizotenganishwa kwa koma, huku `prompt` ikiwa njia mbadala ya kuzitoa.

lyricssi lazima

Ainastring

Chaguomsingi

variancesi lazima

Ainanumber

Chaguomsingi0.5

0 – 1

Variance ya inpainting hudhibiti jinsi matokeo yanavyoweza kuwa tofauti; kuiongeza kunaweza kuleta utofauti zaidi.

number_of_stepssi lazima

Ainainteger

Chaguomsingi27

3 – 60

Idadi ya hatua zinazotumika wakati wa uzalishaji wa sauti.

seedsi lazima

Ainainteger | null

Seed ya uzalishaji unaoweza kurudiwa; huchaguliwa bila mpangilio isipokuwa utoe thamani.

schedulersi lazima

Ainaenum

Chaguomsingieuler

eulerheun

Kiratibu kinachotumika wakati wa uzalishaji.

guidance_typesi lazima

Ainaenum

Chaguomsingiapg

cfgapgcfg_star

Aina ya CFG inayotumika wakati wa uzalishaji.

granularity_scalesi lazima

Ainainteger

Chaguomsingi10

-100 – 100

Kiwango cha granularity kinachotumika wakati wa uzalishaji. Kukiongeza kunaweza kupunguza kasoro.

guidance_intervalsi lazima

Ainanumber

Chaguomsingi0.5

0 – 1

Sehemu ya ratiba ya uzalishaji inayopokea mwongozo: kuchagua 0.5 huiwekea mipaka hatua kutoka 0.25 * infer_steps hadi 0.75 * infer_steps, na kuacha mwanzo na mwisho bila mwongozo.

guidance_interval_decaysi lazima

Ainanumber

Chaguomsingi0

0 – 1

Kupungua kwa mwongozo ndani ya muda wa uzalishaji: 0.0 huacha kupungua kikiwa kimezimwa; vinginevyo, kiwango hupungua katika muda huo kutoka guidance_scale hadi min_guidance_scale.

guidance_scalesi lazima

Ainanumber

Chaguomsingi15

0 – 200

Kiwango cha mwongozo kinachotumika wakati wa uzalishaji.

minimum_guidance_scalesi lazima

Ainanumber

Chaguomsingi3

0 – 200

Kiwango cha chini kabisa cha mwongozo kinachofikiwa baada ya kupungua wakati wa uzalishaji.

tag_guidance_scalesi lazima

Ainanumber

Chaguomsingi5

0 – 10

Kiwango cha mwongozo wa lebo kinachotumika wakati wa uzalishaji.

lyric_guidance_scalesi lazima

Ainanumber

Chaguomsingi1.5

0 – 10

Kiwango cha mwongozo wa maneno ya wimbo kinachotumika wakati wa uzalishaji.

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": "ace-step/audio-inpaint",
  "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": 2,
    "usd": "0.002",
    "charged": 2,
    "refunded": 0
  },
  "input": {
    "tags": "lofi, hiphop, drum and bass, trap, chill",
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "output": {
    "audio": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_name": "0-output.mp3",
      "file_size": 1843200
    },
    "seed": 42,
    "tags": "lofi, hiphop, drum and bass, trap, chill",
    "lyrics": "[inst]"
  },
  "outputs": [
    {
      "type": "audio",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_size": 1843200,
      "duration": 12,
      "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"
  }
}

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

audio: object {url, content_type, file_name, file_size}Faili ya sauti iliyozalishwa.
seed: integerSeed ya nasibu inayotumika wakati wa uzalishaji.
tags: stringLebo za aina ya muziki zinazotumika wakati wa uzalishaji.
lyrics: stringManeno ya wimbo yanayotumika wakati wa uzalishaji.

Miundo zaidi: Maandishi hadi Muziki

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/ace-step/audio-inpaint.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt

Tokeo lako la kwanza linaonekana hapa

Unda ombi

Endesha ombi hili

Kuhusu ACE Step Audio Inpaint

Vigezo

Tokeo

Tofauti nyingine za ACE Step

Miundo zaidi: Maandishi hadi Muziki