Vai al contenuto

ACE Step

Integra

ID del modello 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"

Questa richiesta: 0,012 $ 12 crediti API Esegui in questa pagina

Ottieni la chiave API
ACE Studio Da testo a musica 5–240 s #text-to-audio#text-to-music

Compone musica da tag di genere e testi opzionali, con una durata da 5 a 240 secondi

ACE Studio · Audio

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio

Tag di stile audio forniti come generi separati da virgole, con `prompt` disponibile come metodo alternativo per fornirli.

predefinito 60

Durata, in secondo, dell'audio generato.

Avanzate 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
predefinito

Testo cantato, con le sezioni del brano organizzate usando controlli come [verse], [chorus] e [bridge]. Per audio senza testo cantato, ometti questo input o fornisci solo [inst] o [instrumental].

scheduler predefinito euler

Scheduler usato durante la generazione.

guidance_type predefinito apg

Tipo di CFG usato durante la generazione.

predefinito 27

Numero di passaggi usati durante la generazione audio.

predefinito 10

Scala di granularità applicata durante la generazione. Aumentarla può ridurre gli artefatti.

predefinito 0.5

Porzione della pianificazione della generazione che riceve la guida: scegliere 0.5 la limita ai passaggi da 0.25 * infer_steps a 0.75 * infer_steps, lasciando senza guida l'inizio e la fine.

predefinito 0

Decadimento della guida nell'intervallo di generazione: 0.0 mantiene disabilitato il decadimento; altrimenti, la scala diminuisce nell'intervallo da guidance_scale a min_guidance_scale.

predefinito 15

Scala della guida applicata durante la generazione.

predefinito 3

Scala minima della guida raggiunta dopo il decadimento durante la generazione.

predefinito 5

Scala della guida dei tag applicata durante la generazione.

predefinito 1.5

Scala della guida del testo applicata durante la generazione.

Seed per una generazione riproducibile, scelto casualmente se non fornisci un valore.

POST /run/ace-step?wait=20 preventivo → 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"

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su ACE Step

Crea una traccia musicale da `tags` di stile separati da virgole e `lyrics` opzionali. I marcatori di sezione come [verse] e [chorus] definiscono la struttura del brano, mentre [inst] produce una versione strumentale. `duration` va da 5 a 240 secondi. I controlli di campionamento includono `scheduler` (euler o heun), `guidance_type` e `number_of_steps` da 3 a 60.

Parametri

NomeTipo PredefinitoConsentiti Descrizione
tagsobbligatorio
Tipostring
Tag di stile audio forniti come generi separati da virgole, con `prompt` disponibile come metodo alternativo per fornirli.
lyricsfacoltativo
Tipostring
Predefinito
Testo cantato, con le sezioni del brano organizzate usando controlli come [verse], [chorus] e [bridge]. Per audio senza testo cantato, ometti questo input o fornisci solo [inst] o [instrumental].
durationfacoltativo
Tiponumber
Predefinito60
5 – 240
Durata, in secondo, dell'audio generato.
number_of_stepsfacoltativo
Tipointeger
Predefinito27
3 – 60
Numero di passaggi usati durante la generazione audio.
seedfacoltativo
Tipointeger | null
Seed per una generazione riproducibile, scelto casualmente se non fornisci un valore.
schedulerfacoltativo
Tipoenum
Predefinitoeuler
eulerheun
Scheduler usato durante la generazione.
guidance_typefacoltativo
Tipoenum
Predefinitoapg
cfgapgcfg_star
Tipo di CFG usato durante la generazione.
granularity_scalefacoltativo
Tipointeger
Predefinito10
-100 – 100
Scala di granularità applicata durante la generazione. Aumentarla può ridurre gli artefatti.
guidance_intervalfacoltativo
Tiponumber
Predefinito0.5
0 – 1
Porzione della pianificazione della generazione che riceve la guida: scegliere 0.5 la limita ai passaggi da 0.25 * infer_steps a 0.75 * infer_steps, lasciando senza guida l'inizio e la fine.
guidance_interval_decayfacoltativo
Tiponumber
Predefinito0
0 – 1
Decadimento della guida nell'intervallo di generazione: 0.0 mantiene disabilitato il decadimento; altrimenti, la scala diminuisce nell'intervallo da guidance_scale a min_guidance_scale.
guidance_scalefacoltativo
Tiponumber
Predefinito15
0 – 200
Scala della guida applicata durante la generazione.
minimum_guidance_scalefacoltativo
Tiponumber
Predefinito3
0 – 200
Scala minima della guida raggiunta dopo il decadimento durante la generazione.
tag_guidance_scalefacoltativo
Tiponumber
Predefinito5
0 – 10
Scala della guida dei tag applicata durante la generazione.
lyric_guidance_scalefacoltativo
Tiponumber
Predefinito1.5
0 – 10
Scala della guida del testo applicata durante la generazione.
obbligatorio

Output

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
audio
object {url, content_type, file_name, file_size}File audio prodotto dalla generazione.
seed
integerSeed casuale usato durante la generazione.
tags
stringTag di genere applicati durante la generazione.
lyrics
stringTesto applicato durante la generazione.

Altri modelli: Da testo a musica

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/ace-step.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt