ACE Step Audio Outpaint

Unganisha

Kitambulisho cha modeli ace-step/audio-outpaint

# 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/ace-step/audio-outpaint?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.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/ace-step/audio-outpaint?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.com/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-outpaint", 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": "ace-step/audio-outpaint",
  "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 Outpaint (ace-step/audio-outpaint) kupitia Doitong API. Nyaraka za mawakala: https://doitong.com/sw/developers/models/ace-step/audio-outpaint.md

POST https://api.doitong.com/v1/run/ace-step/audio-outpaint?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.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/ace-step/audio-outpaint yenye mwili uleule hurejesha bei kamili kabla ya kuendesha.

Faili kama mfano: $ 0.006 salio za API 6 faili zako hupimwa kabla ya kuendesha Iendeshe kwenye ukurasa huu

Pata ufunguo wa API

ACE Studio Maandishi hadi Muziki 0–107 s #audio-to-audio#audio-outpaint#audio-extend

Hupanua klipu ya sauti iliyopo kabla ya mwanzo au baada ya mwisho kwa muziki uliotungwa upya

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 kutolewa

Bei kulingana na uingizaji wako

$ 0.0002 / sekunde ya sauti ya tokeo

salio za API 0.2 / sekunde ya sauti ya tokeo

Ombi hili: sekunde 30 × $ 0.0002 $ 0.006 salio za API 6

Endesha · $ 0.006

Hutozwa tu ikifanikiwa, na kurejeshewa kiotomatiki ikishindwa.

extend_before_duration chaguomsingi 0

extend_after_duration chaguomsingi 30

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 outpainting.

tags •inahitajika

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

extend_before_duration chaguomsingi 0

Urefu wa upanuzi kabla ya mwanzo wa sauti, kwa sekunde.

extend_after_duration chaguomsingi 30

Urefu wa upanuzi baada ya mwisho wa sauti, kwa sekunde.

Ya kina lyrics · scheduler · guidance_type · 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.

scheduler chaguomsingi euler

Kiratibu kinachotumika wakati wa uzalishaji.

guidance_type chaguomsingi apg

Aina ya CFG inayotumika wakati wa uzalishaji.

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-outpaint?wait=20 makadirio → $ 0.006

# 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/ace-step/audio-outpaint?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.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/ace-step/audio-outpaint?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.com/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-outpaint", 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-outpaint",
      "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 Outpaint

Huendeleza wimbo uliotolewa kupitia `audio_url`. `extend_before_duration` na `extend_after_duration` kila moja huongeza hadi sekunde 107 mwanzoni au mwishoni, na chaguomsingi ni sekunde 30 baada ya mwisho. Mtindo hutokana na `tags`, pamoja na `lyrics` za hiari kwa sehemu zilizoongezwa. Idadi ya hatua, kipangaji na mipangilio ya mwongozo inalingana na miundo mingine ya ACE Step.

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 outpainting.

extend_before_durationsi lazima

Ainanumber

Chaguomsingi0

0 – 107

Urefu wa upanuzi kabla ya mwanzo wa sauti, kwa sekunde.

extend_after_durationsi lazima

Ainanumber

Chaguomsingi30

0 – 107

Urefu wa upanuzi baada ya mwisho wa sauti, 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

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-outpaint",
  "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": 6,
    "usd": "0.006",
    "charged": 6,
    "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.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

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-outpaint.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 Outpaint

Vigezo

Tokeo

Tofauti nyingine za ACE Step

Miundo zaidi: Maandishi hadi Muziki