ਸਮੱਗਰੀ ਵੱਲ ਜਾਓ

ACE Step

ਇੰਟੀਗ੍ਰੇਟ ਕਰੋ

ਮਾਡਲ id ace-step
# 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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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"

ਇਹ ਬੇਨਤੀ: $0.012 12 API ਕ੍ਰੈਡਿਟ ਇਸ ਪੰਨੇ ’ਤੇ ਚਲਾਓ

API ਕੁੰਜੀ ਲਵੋ
ACE Studio ਟੈਕਸਟ ਤੋਂ ਸੰਗੀਤ 5–240 s #text-to-audio#text-to-music

ਸ਼ੈਲੀ ਟੈਗਾਂ ਅਤੇ ਵਿਕਲਪਿਕ ਬੋਲਾਂ ਤੋਂ ਸੰਗੀਤ ਤਿਆਰ ਕਰਦਾ ਹੈ, ਜਿਸ ਦੀ ਲੰਬਾਈ 5 ਤੋਂ 240 ਸਕਿੰਟ ਹੁੰਦੀ ਹੈ

ACE Studio · ਆਡੀਓ

ਤੁਹਾਡਾ ਪਹਿਲਾ ਨਤੀਜਾ ਇੱਥੇ ਹੋਵੇਗਾ

ਹੇਠਾਂ ਬੇਨਤੀ ਬਣਾਓ ਅਤੇ ਆਪਣੀ API ਕੁੰਜੀ ਨਾਲ ਚਲਾਓ। ਆਉਟਪੁੱਟ ਸਾਡੇ ਸਟੋਰੇਜ ਵਿੱਚ ਕਾਪੀ ਕੀਤੇ ਜਾਂਦੇ ਹਨ ਅਤੇ ਹਮੇਸ਼ਾ ਲਈ ਜਾਂ ਮੁਫ਼ਤ ਵਿੱਚ 7 ਦਿਨ ਤੱਕ ਰੱਖੇ ਜਾਂਦੇ ਹਨ।

ਰਿਕਵੈਸਟ ਬਣਾਓ

ਕੰਟਰੋਲ ਮਾਡਲ ਸਕੀਮਾ ਤੋਂ ਤਿਆਰ ਹੁੰਦੇ ਹਨ। ਤੁਸੀਂ ਬਦਲਾਅ ਕਰਦੇ ਹੀ ਕੋਡ ਅਤੇ ਕੀਮਤ ਅੱਪਡੇਟ ਹੋ ਜਾਂਦੇ ਹਨ।

•ਲੋੜੀਂਦਾ

ਕੋਮਾ ਨਾਲ ਵੱਖ ਕੀਤੇ ਸ਼ੈਲੀਆਂ ਦੇ ਰੂਪ ਵਿੱਚ ਦਿੱਤੇ ਆਡੀਓ ਸਟਾਈਲ ਟੈਗ, ਜਿਨ੍ਹਾਂ ਨੂੰ ਦੇਣ ਲਈ ਵਿਕਲਪ ਵਜੋਂ `prompt` ਵੀ ਉਪਲਬਧ ਹੈ।

ਡਿਫ਼ਾਲਟ 60

ਤਿਆਰ ਕੀਤੇ ਆਡੀਓ ਦੀ ਲੰਬਾਈ, ਸਕਿੰਟਾਂ ਵਿੱਚ।

ਉੱਨਤ 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
ਡਿਫ਼ਾਲਟ

ਗਾਏ ਜਾਣ ਵਾਲੇ ਬੋਲ, ਜਿਨ੍ਹਾਂ ਦੇ ਗੀਤ ਭਾਗ [verse], [chorus] ਅਤੇ [bridge] ਵਰਗੇ ਕੰਟਰੋਲਾਂ ਨਾਲ ਵਿਵਸਥਿਤ ਕੀਤੇ ਜਾਂਦੇ ਹਨ। ਗਾਏ ਬੋਲਾਂ ਤੋਂ ਬਿਨਾਂ ਆਡੀਓ ਲਈ ਇਸ ਇਨਪੁੱਟ ਨੂੰ ਛੱਡੋ ਜਾਂ ਸਿਰਫ਼ [inst] ਜਾਂ [instrumental] ਦਿਓ।

scheduler ਡਿਫ਼ਾਲਟ euler

ਸਿਰਜਣਾ ਦੌਰਾਨ ਵਰਤਿਆ ਗਿਆ ਸ਼ੈਡਿਊਲਰ।

guidance_type ਡਿਫ਼ਾਲਟ apg

ਸਿਰਜਣਾ ਦੌਰਾਨ ਵਰਤੀ ਗਈ CFG ਕਿਸਮ।

ਡਿਫ਼ਾਲਟ 27

ਆਡੀਓ ਸਿਰਜਣਾ ਦੌਰਾਨ ਵਰਤੀ ਗਈ ਕਦਮਾਂ ਦੀ ਗਿਣਤੀ।

ਡਿਫ਼ਾਲਟ 10

ਸਿਰਜਣਾ ਦੌਰਾਨ ਲਾਗੂ ਕੀਤਾ ਗਿਆ ਗ੍ਰੈਨਿਊਲੈਰਿਟੀ ਸਕੇਲ। ਇਸਨੂੰ ਵਧਾਉਣ ਨਾਲ ਆਰਟੀਫੈਕਟ ਘਟ ਸਕਦੇ ਹਨ।

ਡਿਫ਼ਾਲਟ 0.5

ਸਿਰਜਣਾ ਸ਼ੈਡਿਊਲ ਦਾ ਉਹ ਹਿੱਸਾ ਜਿਸਨੂੰ ਗਾਈਡੈਂਸ ਮਿਲਦੀ ਹੈ: 0.5 ਚੁਣਨ ਨਾਲ ਇਹ 0.25 * infer_steps ਤੋਂ 0.75 * infer_steps ਤੱਕ ਦੇ ਕਦਮਾਂ ਤੱਕ ਸੀਮਿਤ ਰਹਿੰਦਾ ਹੈ ਅਤੇ ਸ਼ੁਰੂਆਤ ਤੇ ਅੰਤ ਬਿਨਾਂ ਗਾਈਡੈਂਸ ਦੇ ਰਹਿੰਦੇ ਹਨ।

ਡਿਫ਼ਾਲਟ 0

ਸਿਰਜਣਾ ਅੰਤਰਾਲ ਅੰਦਰ ਗਾਈਡੈਂਸ ਡਿਕੇ: 0.0 ਡਿਕੇ ਨੂੰ ਬੰਦ ਰੱਖਦਾ ਹੈ; ਨਹੀਂ ਤਾਂ ਇਸ ਅੰਤਰਾਲ ਦੌਰਾਨ ਸਕੇਲ guidance_scale ਤੋਂ min_guidance_scale ਤੱਕ ਘਟਦਾ ਹੈ।

ਡਿਫ਼ਾਲਟ 15

ਸਿਰਜਣਾ ਦੌਰਾਨ ਲਾਗੂ ਕੀਤੀ ਗਈ ਗਾਈਡੈਂਸ ਦਾ ਸਕੇਲ।

ਡਿਫ਼ਾਲਟ 3

ਸਿਰਜਣਾ ਦੌਰਾਨ ਡਿਕੇ ਤੋਂ ਬਾਅਦ ਪਹੁੰਚਿਆ ਸਭ ਤੋਂ ਘੱਟ ਗਾਈਡੈਂਸ ਸਕੇਲ।

ਡਿਫ਼ਾਲਟ 5

ਸਿਰਜਣਾ ਦੌਰਾਨ ਲਾਗੂ ਕੀਤੀ ਟੈਗ ਗਾਈਡੈਂਸ ਦਾ ਸਕੇਲ।

ਡਿਫ਼ਾਲਟ 1.5

ਸਿਰਜਣਾ ਦੌਰਾਨ ਲਾਗੂ ਕੀਤੀ ਬੋਲਾਂ ਦੀ ਗਾਈਡੈਂਸ ਦਾ ਸਕੇਲ।

ਦੁਹਰਾਈ ਜਾ ਸਕਣ ਵਾਲੀ ਸਿਰਜਣਾ ਲਈ ਸੀਡ, ਜਦੋਂ ਤੱਕ ਤੁਸੀਂ ਮੁੱਲ ਨਾ ਦਿਓ, ਬੇਤਰਤੀਬੇ ਢੰਗ ਨਾਲ ਚੁਣਿਆ ਜਾਂਦਾ ਹੈ।

POST /run/ace-step?wait=20 ਕੋਟ → $0.012
# 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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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"

ਇਹ ਬੇਨਤੀ ਚਲਾਓ

ਤੁਹਾਡੀ key ਇਸ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਰਹਿੰਦੀ ਹੈ: ਇਹ ਸਿਰਫ਼ Doitong API ਨੂੰ ਭੇਜੀ ਜਾਂਦੀ ਹੈ ਅਤੇ ਸਿਰਫ਼ ਤਾਂ ਹੀ (localStorage) ਵਿੱਚ ਸੁਰੱਖਿਅਤ ਹੁੰਦੀ ਹੈ ਜੇ ਤੁਸੀਂ Remember ਚੁਣੋ। API ਕੁੰਜੀ ਪ੍ਰਾਪਤ ਕਰੋ

ACE Step ਬਾਰੇ

ਕੌਮਿਆਂ ਨਾਲ ਵੱਖ ਕੀਤੇ ਸੰਗੀਤਕ ਸ਼ੈਲੀ ਦੇ `tags` ਅਤੇ ਵਿਕਲਪਿਕ `lyrics` ਤੋਂ ਸੰਗੀਤ ਟ੍ਰੈਕ ਬਣਾਉਂਦਾ ਹੈ। [verse] ਅਤੇ [chorus] ਵਰਗੇ ਸੈਕਸ਼ਨ ਮਾਰਕਰ ਗੀਤ ਦੀ ਬਣਤਰ ਤੈਅ ਕਰਦੇ ਹਨ, ਜਦਕਿ [inst] ਇੰਸਟ੍ਰੂਮੈਂਟਲ ਤਿਆਰ ਕਰਦਾ ਹੈ। `duration` 5 ਤੋਂ 240 ਸਕਿੰਟ ਤੱਕ ਹੁੰਦਾ ਹੈ। ਸੈਂਪਲਿੰਗ ਕੰਟਰੋਲਾਂ ਵਿੱਚ `scheduler` (euler ਜਾਂ heun), `guidance_type`, ਅਤੇ 3 ਤੋਂ 60 ਤੱਕ `number_of_steps` ਸ਼ਾਮਲ ਹਨ।

ਪੈਰਾਮੀਟਰ

ਨਾਮਕਿਸਮ ਡਿਫ਼ਾਲਟਮਨਜ਼ੂਰਸ਼ੁਦਾ ਵੇਰਵਾ
tagsਲੋੜੀਂਦਾ
ਕਿਸਮstring
ਕੋਮਾ ਨਾਲ ਵੱਖ ਕੀਤੇ ਸ਼ੈਲੀਆਂ ਦੇ ਰੂਪ ਵਿੱਚ ਦਿੱਤੇ ਆਡੀਓ ਸਟਾਈਲ ਟੈਗ, ਜਿਨ੍ਹਾਂ ਨੂੰ ਦੇਣ ਲਈ ਵਿਕਲਪ ਵਜੋਂ `prompt` ਵੀ ਉਪਲਬਧ ਹੈ।
lyricsਵਿਕਲਪਿਕ
ਕਿਸਮstring
ਡਿਫ਼ਾਲਟ
ਗਾਏ ਜਾਣ ਵਾਲੇ ਬੋਲ, ਜਿਨ੍ਹਾਂ ਦੇ ਗੀਤ ਭਾਗ [verse], [chorus] ਅਤੇ [bridge] ਵਰਗੇ ਕੰਟਰੋਲਾਂ ਨਾਲ ਵਿਵਸਥਿਤ ਕੀਤੇ ਜਾਂਦੇ ਹਨ। ਗਾਏ ਬੋਲਾਂ ਤੋਂ ਬਿਨਾਂ ਆਡੀਓ ਲਈ ਇਸ ਇਨਪੁੱਟ ਨੂੰ ਛੱਡੋ ਜਾਂ ਸਿਰਫ਼ [inst] ਜਾਂ [instrumental] ਦਿਓ।
durationਵਿਕਲਪਿਕ
ਕਿਸਮnumber
ਡਿਫ਼ਾਲਟ60
5 – 240
ਤਿਆਰ ਕੀਤੇ ਆਡੀਓ ਦੀ ਲੰਬਾਈ, ਸਕਿੰਟਾਂ ਵਿੱਚ।
number_of_stepsਵਿਕਲਪਿਕ
ਕਿਸਮinteger
ਡਿਫ਼ਾਲਟ27
3 – 60
ਆਡੀਓ ਸਿਰਜਣਾ ਦੌਰਾਨ ਵਰਤੀ ਗਈ ਕਦਮਾਂ ਦੀ ਗਿਣਤੀ।
seedਵਿਕਲਪਿਕ
ਕਿਸਮinteger | null
ਦੁਹਰਾਈ ਜਾ ਸਕਣ ਵਾਲੀ ਸਿਰਜਣਾ ਲਈ ਸੀਡ, ਜਦੋਂ ਤੱਕ ਤੁਸੀਂ ਮੁੱਲ ਨਾ ਦਿਓ, ਬੇਤਰਤੀਬੇ ਢੰਗ ਨਾਲ ਚੁਣਿਆ ਜਾਂਦਾ ਹੈ।
schedulerਵਿਕਲਪਿਕ
ਕਿਸਮenum
ਡਿਫ਼ਾਲਟeuler
eulerheun
ਸਿਰਜਣਾ ਦੌਰਾਨ ਵਰਤਿਆ ਗਿਆ ਸ਼ੈਡਿਊਲਰ।
guidance_typeਵਿਕਲਪਿਕ
ਕਿਸਮenum
ਡਿਫ਼ਾਲਟapg
cfgapgcfg_star
ਸਿਰਜਣਾ ਦੌਰਾਨ ਵਰਤੀ ਗਈ CFG ਕਿਸਮ।
granularity_scaleਵਿਕਲਪਿਕ
ਕਿਸਮinteger
ਡਿਫ਼ਾਲਟ10
-100 – 100
ਸਿਰਜਣਾ ਦੌਰਾਨ ਲਾਗੂ ਕੀਤਾ ਗਿਆ ਗ੍ਰੈਨਿਊਲੈਰਿਟੀ ਸਕੇਲ। ਇਸਨੂੰ ਵਧਾਉਣ ਨਾਲ ਆਰਟੀਫੈਕਟ ਘਟ ਸਕਦੇ ਹਨ।
guidance_intervalਵਿਕਲਪਿਕ
ਕਿਸਮnumber
ਡਿਫ਼ਾਲਟ0.5
0 – 1
ਸਿਰਜਣਾ ਸ਼ੈਡਿਊਲ ਦਾ ਉਹ ਹਿੱਸਾ ਜਿਸਨੂੰ ਗਾਈਡੈਂਸ ਮਿਲਦੀ ਹੈ: 0.5 ਚੁਣਨ ਨਾਲ ਇਹ 0.25 * infer_steps ਤੋਂ 0.75 * infer_steps ਤੱਕ ਦੇ ਕਦਮਾਂ ਤੱਕ ਸੀਮਿਤ ਰਹਿੰਦਾ ਹੈ ਅਤੇ ਸ਼ੁਰੂਆਤ ਤੇ ਅੰਤ ਬਿਨਾਂ ਗਾਈਡੈਂਸ ਦੇ ਰਹਿੰਦੇ ਹਨ।
guidance_interval_decayਵਿਕਲਪਿਕ
ਕਿਸਮnumber
ਡਿਫ਼ਾਲਟ0
0 – 1
ਸਿਰਜਣਾ ਅੰਤਰਾਲ ਅੰਦਰ ਗਾਈਡੈਂਸ ਡਿਕੇ: 0.0 ਡਿਕੇ ਨੂੰ ਬੰਦ ਰੱਖਦਾ ਹੈ; ਨਹੀਂ ਤਾਂ ਇਸ ਅੰਤਰਾਲ ਦੌਰਾਨ ਸਕੇਲ guidance_scale ਤੋਂ min_guidance_scale ਤੱਕ ਘਟਦਾ ਹੈ।
guidance_scaleਵਿਕਲਪਿਕ
ਕਿਸਮnumber
ਡਿਫ਼ਾਲਟ15
0 – 200
ਸਿਰਜਣਾ ਦੌਰਾਨ ਲਾਗੂ ਕੀਤੀ ਗਈ ਗਾਈਡੈਂਸ ਦਾ ਸਕੇਲ।
minimum_guidance_scaleਵਿਕਲਪਿਕ
ਕਿਸਮnumber
ਡਿਫ਼ਾਲਟ3
0 – 200
ਸਿਰਜਣਾ ਦੌਰਾਨ ਡਿਕੇ ਤੋਂ ਬਾਅਦ ਪਹੁੰਚਿਆ ਸਭ ਤੋਂ ਘੱਟ ਗਾਈਡੈਂਸ ਸਕੇਲ।
tag_guidance_scaleਵਿਕਲਪਿਕ
ਕਿਸਮnumber
ਡਿਫ਼ਾਲਟ5
0 – 10
ਸਿਰਜਣਾ ਦੌਰਾਨ ਲਾਗੂ ਕੀਤੀ ਟੈਗ ਗਾਈਡੈਂਸ ਦਾ ਸਕੇਲ।
lyric_guidance_scaleਵਿਕਲਪਿਕ
ਕਿਸਮnumber
ਡਿਫ਼ਾਲਟ1.5
0 – 10
ਸਿਰਜਣਾ ਦੌਰਾਨ ਲਾਗੂ ਕੀਤੀ ਬੋਲਾਂ ਦੀ ਗਾਈਡੈਂਸ ਦਾ ਸਕੇਲ।
ਲੋੜੀਂਦਾ

ਆਉਟਪੁੱਟ

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ace-step",
  "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": 12,
    "usd": "0.012",
    "charged": 12,
    "refunded": 0
  },
  "input": {
    "tags": "lofi, hiphop, drum and bass, trap, chill"
  },
  "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"
  }
}
ਤੁਹਾਡੀਆਂ ਫ਼ਾਈਲਾਂ, ਤੁਹਾਡੀ ਚੋਣਹਰ outputs[].url ਸਾਡੇ ਸਟੋਰੇਜ ਵਿੱਚ ਇੱਕ ਕਾਪੀ ਹੈ: ਹਮੇਸ਼ਾ ਲਈ ਰੱਖੀ ਜਾਂਦੀ ਹੈ (ਪ੍ਰਤੀ GB-ਮਹੀਨਾ ਭੁਗਤਾਨ) ਜਾਂ 7 ਦਿਨ ਤੱਕ ਮੁਫ਼ਤ, ਤੁਹਾਡੀ ਖਾਤਾ ਸੈਟਿੰਗ ਜਾਂ ?storage= ਅਨੁਸਾਰ।
ਹਰ ਮਾਡਲ ’ਤੇ ਇੱਕੋ ਜਿਹਾ ਰੂਪਤਸਵੀਰਾਂ, ਵੀਡੀਓ ਅਤੇ ਆਡੀਓ ਸਭ ਲਈ type, url, content_type, width, height ਅਤੇ duration। output ਮਾਡਲ ਦਾ ਆਪਣਾ ਨਤੀਜਾ ਆਬਜੈਕਟ ਹੈ।
ਆਉਟਪੁੱਟ ਦੇ ਫ਼ੀਲਡ
audio
object {url, content_type, file_name, file_size}ਸਿਰਜਣਾ ਨਾਲ ਤਿਆਰ ਕੀਤੀ ਆਡੀਓ ਫ਼ਾਈਲ।
seed
integerਸਿਰਜਣਾ ਦੌਰਾਨ ਵਰਤਿਆ ਗਿਆ ਬੇਤਰਤੀਬਾ ਸੀਡ।
tags
stringਸਿਰਜਣਾ ਦੌਰਾਨ ਲਾਗੂ ਕੀਤੇ ਗਏ ਸ਼ੈਲੀ ਟੈਗ।
lyrics
stringਸਿਰਜਣਾ ਦੌਰਾਨ ਲਾਗੂ ਕੀਤੇ ਗਏ ਬੋਲ।

ਹੋਰ ਮਾਡਲ: ਟੈਕਸਟ ਤੋਂ ਸੰਗੀਤ

AI ਏਜੰਟਾਂ ਲਈ: ਇਹ ਪੰਨਾ Markdown ਵਜੋਂ ਇੱਥੇ ਹੈ https://doitong.com/pa/developers/models/ace-step.md. ਸਾਰੇ ਮਾਡਲ ਅਤੇ ਗਾਈਡ: https://doitong.com/developers/llms.txt