API Acestep AI Ace Step | Tarifs et documentation

acestep-ai/ace-step/text-to-audio

Créez des morceaux pouvant durer jusqu’à 4 minutes à partir de tags de style et de paroles facultatives, avec des voix originales et une grande fidélité acoustique, dans RunComfy Models et via l’API HTTP.

Table des matières

1. Démarrage

Utilisez l'API RunComfy pour exécuter acestep-ai/ace-step/text-to-audio. Pour les entrées et sorties acceptées, voir le schéma.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/acestep-ai/ace-step/text-to-audio \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "tags": "lofi, hiphop, chill, mellow piano, soft drums, late-night study vibe"
  }'

2. Authentification

Définissez la variable d'environnement YOUR_API_TOKEN avec votre clé API (gestion dans Profil) et incluez à chaque requête un jeton Bearer dans l'en-tête Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Référence API

Soumettre une requête

Soumettez une tâche de génération asynchrone et recevez immédiatement un request_id ainsi que des URLs pour le statut, les résultats et l'annulation.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/acestep-ai/ace-step/text-to-audio \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "tags": "lofi, hiphop, chill, mellow piano, soft drums, late-night study vibe"
  }'

Statut de la requête

Récupère l'état actuel pour un request_id (« in_queue », « in_progress », « completed » ou « cancelled »).

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Récupérer les résultats

Récupère les sorties finales et métadonnées pour le request_id ; si le travail n'est pas terminé, la réponse indique l'état actuel pour poursuivre le polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Annuler une requête

Annule un travail en file d'attente via request_id ; les travaux en cours ne peuvent pas être annulés.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Fichiers en entrée

Fichier hébergé (URL)

Fournissez une URL HTTPS accessible publiquement. L'hôte doit autoriser les récupérations côté serveur (sans login/cookies), sans limitation de débit ni blocage des bots. Recommandé : images ≤ 50 Mo (~4K), vidéos ≤ 100 Mo (~2–5 min en 720p). Préférez des URL stables ou pré-signées pour les actifs privés.

5. Schéma

Schéma d'entrée

{
  "type": "object",
  "title": "Schéma d'entrée",
  "required": [
    "tags"
  ],
  "properties": {
    "tags": {
      "title": "Tags",
      "description": "Liste de genres, d’ambiances et d’instruments séparés par des virgules, utilisée pour orienter le style du morceau.",
      "type": "string",
      "default": "lofi, hiphop, chill, mellow piano, soft drums, late-night study vibe"
    },
    "lyrics": {
      "title": "Paroles",
      "description": "Contenu vocal facultatif. Laissez le champ vide pour que l’IA écrive les paroles, ou utilisez [inst] / [instrumental] pour supprimer le chant.",
      "type": "string",
      "default": "[Verse]\nCity lights blur the rainy streets\nHeadphones on, my heart keeps the beat\n[Chorus]\nLate nights, low lights, holding on tight\nDreaming in colors under neon skylight"
    },
    "duration": {
      "title": "Durée (secondes)",
      "description": "Durée de l’audio en secondes.",
      "type": "integer",
      "minimum": 5,
      "maximum": 240,
      "default": 60
    },
    "seed": {
      "title": "Seed",
      "description": "",
      "type": "integer",
      "minimum": -1,
      "maximum": 2147483647,
      "default": -1
    }
  }
}

Schéma de sortie

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL d'une seule image"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL d'une seule vidéo"
      },
      "images": {
        "type": "array",
        "description": "plusieurs URLs d'images",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "plusieurs URLs de vidéos",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

RunComfy

RunComfy est la première ComfyUI plateforme, offrant des ComfyUI en ligne environnement et services, ainsi que des workflows ComfyUI proposant des visuels époustouflants. RunComfy propose également AI Models, permettant aux artistes d'utiliser les derniers outils d'IA pour créer des œuvres d'art incroyables.

1. Démarrage

Utilisez l'API RunComfy pour exécuter acestep-ai/ace-step/text-to-audio. Pour les entrées et sorties acceptées, voir le schéma.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/acestep-ai/ace-step/text-to-audio \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "tags": "lofi, hiphop, chill, mellow piano, soft drums, late-night study vibe"
  }'

3. Référence API

Soumettre une requête

Soumettez une tâche de génération asynchrone et recevez immédiatement un request_id ainsi que des URLs pour le statut, les résultats et l'annulation.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/acestep-ai/ace-step/text-to-audio \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "tags": "lofi, hiphop, chill, mellow piano, soft drums, late-night study vibe"
  }'

Statut de la requête

Récupère l'état actuel pour un request_id (« in_queue », « in_progress », « completed » ou « cancelled »).

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Récupérer les résultats

Récupère les sorties finales et métadonnées pour le request_id ; si le travail n'est pas terminé, la réponse indique l'état actuel pour poursuivre le polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Annuler une requête

Annule un travail en file d'attente via request_id ; les travaux en cours ne peuvent pas être annulés.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Fichiers en entrée

Fichier hébergé (URL)

5. Schéma

Schéma d'entrée

{
  "type": "object",
  "title": "Schéma d'entrée",
  "required": [
    "tags"
  ],
  "properties": {
    "tags": {
      "title": "Tags",
      "description": "Liste de genres, d’ambiances et d’instruments séparés par des virgules, utilisée pour orienter le style du morceau.",
      "type": "string",
      "default": "lofi, hiphop, chill, mellow piano, soft drums, late-night study vibe"
    },
    "lyrics": {
      "title": "Paroles",
      "description": "Contenu vocal facultatif. Laissez le champ vide pour que l’IA écrive les paroles, ou utilisez [inst] / [instrumental] pour supprimer le chant.",
      "type": "string",
      "default": "[Verse]\nCity lights blur the rainy streets\nHeadphones on, my heart keeps the beat\n[Chorus]\nLate nights, low lights, holding on tight\nDreaming in colors under neon skylight"
    },
    "duration": {
      "title": "Durée (secondes)",
      "description": "Durée de l’audio en secondes.",
      "type": "integer",
      "minimum": 5,
      "maximum": 240,
      "default": 60
    },
    "seed": {
      "title": "Seed",
      "description": "",
      "type": "integer",
      "minimum": -1,
      "maximum": 2147483647,
      "default": -1
    }
  }
}

Schéma de sortie

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL d'une seule image"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL d'une seule vidéo"
      },
      "images": {
        "type": "array",
        "description": "plusieurs URLs d'images",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "plusieurs URLs de vidéos",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

Ace Step : génération musicale avec voix, paroles et contrôle du style par tags dans Models et via l’API | RunComfy

Créez des morceaux pouvant durer jusqu’à 4 minutes à partir de tags de style et de paroles facultatives, avec des voix originales et une grande fidélité acoustique, dans RunComfy Models et via l’API HTTP.

Table des matières

1. Démarrage

2. Authentification

3. Référence API

Soumettre une requête

Statut de la requête

Récupérer les résultats

Annuler une requête

4. Fichiers en entrée

Fichier hébergé (URL)

5. Schéma

Schéma d'entrée

Schéma de sortie

Ace Step : génération musicale avec voix, paroles et contrôle du style par tags dans Models et via l’API | RunComfy

Créez des morceaux pouvant durer jusqu’à 4 minutes à partir de tags de style et de paroles facultatives, avec des voix originales et une grande fidélité acoustique, dans RunComfy Models et via l’API HTTP.

Table des matières

1. Démarrage

2. Authentification

3. Référence API

Soumettre une requête

Statut de la requête

Récupérer les résultats

Annuler une requête

4. Fichiers en entrée

Fichier hébergé (URL)

5. Schéma

Schéma d'entrée

Schéma de sortie