ACE-Step v1.5 Base
ACE-Step v1.5 Base is an open-source music generation foundation model built on a hybrid LLM planner and Diffusion Transformer architecture. It generates full tracks from text prompts with support for voice cloning, lyric editing, remixing, cover generation, and compositions up to 10 minutes. It supports over 50 languages and runs on consumer hardware with under 4GB VRAM.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples4
CODE
Ready-to-use code snippets for common workflows
text-to-audio
Ceramic Heat Battery Explainer Song$0.0039~13s0:00
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'runware:ace-step@v1.5-base',
positivePrompt: 'Create a complete original English explainer song for a B2B film about thermal batteries in ceramic manufacturing. Blend warm documentary narration with restrained melodic singing: an assured female alto delivers the technical lines clearly, then opens into a memorable sung refrain. Organic industrial chamber-folk production with prepared piano, muted marimba, bowed upright bass, brushed frame drum, soft ceramic clicks, and a low kiln-like air hum. Begin sparse and tactile, build gently as the process becomes clear, and finish with a calm, resolved mnemonic hook. Intelligent, practical, quietly optimistic, and credible rather than glossy. Keep every lyric intelligible, with natural phrasing and enough space for the explanation. No hard sell, no exaggerated climate claims, no EDM, no synthwave, no funk, no brass fanfare, and no crowd vocals.',
duration: 60,
settings: {
lyrics: '[Spoken Intro]\nA kiln remembers every flame.\nNow it can remember the wind and sun, too.\n\n[Verse]\nWhen renewable power is plentiful,\nelectric heaters warm a core of refractory brick.\nLayer by layer, heat is held inside,\nquietly waiting behind insulated steel.\n\n[Spoken]\nWhen production calls, controlled air moves through the core,\ncarrying stored heat back to the kiln.\nNo combustion in the battery.\nNo change to the clay.\nJust dependable heat, ready for the next firing.\n\n[Refrain]\nBank the heat when clean power flows.\nBring it back when the kiln door closes.\nHold the hours. Shape the flame.\nMake tomorrow from the same old clay.\n\n[Outro]\nFor tiles, tableware, and technical ceramics:\nsteady temperatures, lower fuel demand,\nand energy that works around the production day.\n\n[Sung Tag]\nBank the heat.\nShape what comes next.',
guidanceType: 'apg',
bpm: 112,
timeSignature: 4,
keyScale: 'C minor',
vocalLanguage: 'en'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "runware:ace-step@v1.5-base",
"positivePrompt": "Create a complete original English explainer song for a B2B film about thermal batteries in ceramic manufacturing. Blend warm documentary narration with restrained melodic singing: an assured female alto delivers the technical lines clearly, then opens into a memorable sung refrain. Organic industrial chamber-folk production with prepared piano, muted marimba, bowed upright bass, brushed frame drum, soft ceramic clicks, and a low kiln-like air hum. Begin sparse and tactile, build gently as the process becomes clear, and finish with a calm, resolved mnemonic hook. Intelligent, practical, quietly optimistic, and credible rather than glossy. Keep every lyric intelligible, with natural phrasing and enough space for the explanation. No hard sell, no exaggerated climate claims, no EDM, no synthwave, no funk, no brass fanfare, and no crowd vocals.",
"duration": 60,
"settings": {
"lyrics": "[Spoken Intro]\nA kiln remembers every flame.\nNow it can remember the wind and sun, too.\n\n[Verse]\nWhen renewable power is plentiful,\nelectric heaters warm a core of refractory brick.\nLayer by layer, heat is held inside,\nquietly waiting behind insulated steel.\n\n[Spoken]\nWhen production calls, controlled air moves through the core,\ncarrying stored heat back to the kiln.\nNo combustion in the battery.\nNo change to the clay.\nJust dependable heat, ready for the next firing.\n\n[Refrain]\nBank the heat when clean power flows.\nBring it back when the kiln door closes.\nHold the hours. Shape the flame.\nMake tomorrow from the same old clay.\n\n[Outro]\nFor tiles, tableware, and technical ceramics:\nsteady temperatures, lower fuel demand,\nand energy that works around the production day.\n\n[Sung Tag]\nBank the heat.\nShape what comes next.",
"guidanceType": "apg",
"bpm": 112,
"timeSignature": 4,
"keyScale": "C minor",
"vocalLanguage": "en"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "audioInference",
"taskUUID": "7fc96bd8-41bc-4da9-a007-c7edfbdb7696",
"model": "runware:ace-step@v1.5-base",
"positivePrompt": "Create a complete original English explainer song for a B2B film about thermal batteries in ceramic manufacturing. Blend warm documentary narration with restrained melodic singing: an assured female alto delivers the technical lines clearly, then opens into a memorable sung refrain. Organic industrial chamber-folk production with prepared piano, muted marimba, bowed upright bass, brushed frame drum, soft ceramic clicks, and a low kiln-like air hum. Begin sparse and tactile, build gently as the process becomes clear, and finish with a calm, resolved mnemonic hook. Intelligent, practical, quietly optimistic, and credible rather than glossy. Keep every lyric intelligible, with natural phrasing and enough space for the explanation. No hard sell, no exaggerated climate claims, no EDM, no synthwave, no funk, no brass fanfare, and no crowd vocals.",
"duration": 60,
"settings": {
"lyrics": "[Spoken Intro]\nA kiln remembers every flame.\nNow it can remember the wind and sun, too.\n\n[Verse]\nWhen renewable power is plentiful,\nelectric heaters warm a core of refractory brick.\nLayer by layer, heat is held inside,\nquietly waiting behind insulated steel.\n\n[Spoken]\nWhen production calls, controlled air moves through the core,\ncarrying stored heat back to the kiln.\nNo combustion in the battery.\nNo change to the clay.\nJust dependable heat, ready for the next firing.\n\n[Refrain]\nBank the heat when clean power flows.\nBring it back when the kiln door closes.\nHold the hours. Shape the flame.\nMake tomorrow from the same old clay.\n\n[Outro]\nFor tiles, tableware, and technical ceramics:\nsteady temperatures, lower fuel demand,\nand energy that works around the production day.\n\n[Sung Tag]\nBank the heat.\nShape what comes next.",
"guidanceType": "apg",
"bpm": 112,
"timeSignature": 4,
"keyScale": "C minor",
"vocalLanguage": "en"
}
}
]'runware run runware:ace-step@v1.5-base \
positivePrompt="Create a complete original English explainer song for a B2B film about thermal batteries in ceramic manufacturing. Blend warm documentary narration with restrained melodic singing: an assured female alto delivers the technical lines clearly, then opens into a memorable sung refrain. Organic industrial chamber-folk production with prepared piano, muted marimba, bowed upright bass, brushed frame drum, soft ceramic clicks, and a low kiln-like air hum. Begin sparse and tactile, build gently as the process becomes clear, and finish with a calm, resolved mnemonic hook. Intelligent, practical, quietly optimistic, and credible rather than glossy. Keep every lyric intelligible, with natural phrasing and enough space for the explanation. No hard sell, no exaggerated climate claims, no EDM, no synthwave, no funk, no brass fanfare, and no crowd vocals." \
duration=60 \
settings.lyrics="[Spoken Intro]
A kiln remembers every flame.
Now it can remember the wind and sun, too.
[Verse]
When renewable power is plentiful,
electric heaters warm a core of refractory brick.
Layer by layer, heat is held inside,
quietly waiting behind insulated steel.
[Spoken]
When production calls, controlled air moves through the core,
carrying stored heat back to the kiln.
No combustion in the battery.
No change to the clay.
Just dependable heat, ready for the next firing.
[Refrain]
Bank the heat when clean power flows.
Bring it back when the kiln door closes.
Hold the hours. Shape the flame.
Make tomorrow from the same old clay.
[Outro]
For tiles, tableware, and technical ceramics:
steady temperatures, lower fuel demand,
and energy that works around the production day.
[Sung Tag]
Bank the heat.
Shape what comes next." \
settings.guidanceType=apg \
settings.bpm=112 \
settings.timeSignature=4 \
settings.keyScale="C minor" \
settings.vocalLanguage=en{
"taskType": "audioInference",
"taskUUID": "7fc96bd8-41bc-4da9-a007-c7edfbdb7696",
"model": "runware:ace-step@v1.5-base",
"positivePrompt": "Create a complete original English explainer song for a B2B film about thermal batteries in ceramic manufacturing. Blend warm documentary narration with restrained melodic singing: an assured female alto delivers the technical lines clearly, then opens into a memorable sung refrain. Organic industrial chamber-folk production with prepared piano, muted marimba, bowed upright bass, brushed frame drum, soft ceramic clicks, and a low kiln-like air hum. Begin sparse and tactile, build gently as the process becomes clear, and finish with a calm, resolved mnemonic hook. Intelligent, practical, quietly optimistic, and credible rather than glossy. Keep every lyric intelligible, with natural phrasing and enough space for the explanation. No hard sell, no exaggerated climate claims, no EDM, no synthwave, no funk, no brass fanfare, and no crowd vocals.",
"duration": 60,
"settings": {
"lyrics": "[Spoken Intro]\nA kiln remembers every flame.\nNow it can remember the wind and sun, too.\n\n[Verse]\nWhen renewable power is plentiful,\nelectric heaters warm a core of refractory brick.\nLayer by layer, heat is held inside,\nquietly waiting behind insulated steel.\n\n[Spoken]\nWhen production calls, controlled air moves through the core,\ncarrying stored heat back to the kiln.\nNo combustion in the battery.\nNo change to the clay.\nJust dependable heat, ready for the next firing.\n\n[Refrain]\nBank the heat when clean power flows.\nBring it back when the kiln door closes.\nHold the hours. Shape the flame.\nMake tomorrow from the same old clay.\n\n[Outro]\nFor tiles, tableware, and technical ceramics:\nsteady temperatures, lower fuel demand,\nand energy that works around the production day.\n\n[Sung Tag]\nBank the heat.\nShape what comes next.",
"guidanceType": "apg",
"bpm": 112,
"timeSignature": 4,
"keyScale": "C minor",
"vocalLanguage": "en"
}
}Response
{
"taskType": "audioInference",
"taskUUID": "7fc96bd8-41bc-4da9-a007-c7edfbdb7696",
"audioUUID": "9906c8f5-83a5-4cb3-bc07-8b92bd327861",
"audioURL": "https://am.runware.ai/audio/os/a02d21/ws/5/ai/9906c8f5-83a5-4cb3-bc07-8b92bd327861.mp3",
"seed": 1335286701,
"cost": 0.0039
}audio-driven
Avalanche Beacon Training Narration$0.0163~32s0:00
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'runware:ace-step@v1.5-base',
positivePrompt: 'Transform the supplied musical source into a newly arranged Nordic electroacoustic documentary bed for a professional avalanche-rescue e-learning lesson. Preserve the source\'s recognizable five-note motif, harmonic movement, and measured pulse, but reorchestrate them with felt piano, bowed vibraphone, low cello harmonics, subtle granular wind textures, and a muted frame drum. The mood is focused, reassuring, and cold-clear rather than dramatic. Use spacious, modern public-broadcast production with restrained dynamics and seamless transitions. Keep the music beneath the voice and gently duck it during key instructions. Add one calm, authoritative adult female instructor speaking natural English with precise diction, moderate pacing, and no sung delivery. Narration, spoken verbatim: "Before leaving the trailhead, switch every transceiver to send and complete a group check. If an avalanche occurs, move to a safe position, call emergency services, and switch every rescuer\'s beacon to search. Follow the direction and distance display quickly at first. Inside ten meters, slow down. Below three meters, keep the beacon close to the snow and use a careful cross pattern to find the lowest reading. Probe perpendicular to the surface. When you strike the victim, leave the probe in place and begin shoveling from downhill." End with a brief, resolved instrumental reprise of the source motif.',
negativePrompt: 'Singing, chanting, choir, theatrical acting, alarmist tone, action-movie percussion, loud music over speech, distorted narration, slurred words, excessive reverb, abrupt ending.',
strength: 0.65,
settings: {
guidanceType: 'apg'
},
inputs: {
audio: 'https://assets.runware.ai/assets/inputs/1f61c8cd-e262-4a82-b4eb-6c4b0d6f1f76.mp3'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "runware:ace-step@v1.5-base",
"positivePrompt": "Transform the supplied musical source into a newly arranged Nordic electroacoustic documentary bed for a professional avalanche-rescue e-learning lesson. Preserve the source's recognizable five-note motif, harmonic movement, and measured pulse, but reorchestrate them with felt piano, bowed vibraphone, low cello harmonics, subtle granular wind textures, and a muted frame drum. The mood is focused, reassuring, and cold-clear rather than dramatic. Use spacious, modern public-broadcast production with restrained dynamics and seamless transitions. Keep the music beneath the voice and gently duck it during key instructions. Add one calm, authoritative adult female instructor speaking natural English with precise diction, moderate pacing, and no sung delivery. Narration, spoken verbatim: \"Before leaving the trailhead, switch every transceiver to send and complete a group check. If an avalanche occurs, move to a safe position, call emergency services, and switch every rescuer's beacon to search. Follow the direction and distance display quickly at first. Inside ten meters, slow down. Below three meters, keep the beacon close to the snow and use a careful cross pattern to find the lowest reading. Probe perpendicular to the surface. When you strike the victim, leave the probe in place and begin shoveling from downhill.\" End with a brief, resolved instrumental reprise of the source motif.",
"negativePrompt": "Singing, chanting, choir, theatrical acting, alarmist tone, action-movie percussion, loud music over speech, distorted narration, slurred words, excessive reverb, abrupt ending.",
"strength": 0.65,
"settings": {
"guidanceType": "apg"
},
"inputs": {
"audio": "https://assets.runware.ai/assets/inputs/1f61c8cd-e262-4a82-b4eb-6c4b0d6f1f76.mp3"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "audioInference",
"taskUUID": "d419ae88-b5e9-4c2e-ac78-f93f7de89aa7",
"model": "runware:ace-step@v1.5-base",
"positivePrompt": "Transform the supplied musical source into a newly arranged Nordic electroacoustic documentary bed for a professional avalanche-rescue e-learning lesson. Preserve the source's recognizable five-note motif, harmonic movement, and measured pulse, but reorchestrate them with felt piano, bowed vibraphone, low cello harmonics, subtle granular wind textures, and a muted frame drum. The mood is focused, reassuring, and cold-clear rather than dramatic. Use spacious, modern public-broadcast production with restrained dynamics and seamless transitions. Keep the music beneath the voice and gently duck it during key instructions. Add one calm, authoritative adult female instructor speaking natural English with precise diction, moderate pacing, and no sung delivery. Narration, spoken verbatim: \"Before leaving the trailhead, switch every transceiver to send and complete a group check. If an avalanche occurs, move to a safe position, call emergency services, and switch every rescuer's beacon to search. Follow the direction and distance display quickly at first. Inside ten meters, slow down. Below three meters, keep the beacon close to the snow and use a careful cross pattern to find the lowest reading. Probe perpendicular to the surface. When you strike the victim, leave the probe in place and begin shoveling from downhill.\" End with a brief, resolved instrumental reprise of the source motif.",
"negativePrompt": "Singing, chanting, choir, theatrical acting, alarmist tone, action-movie percussion, loud music over speech, distorted narration, slurred words, excessive reverb, abrupt ending.",
"strength": 0.65,
"settings": {
"guidanceType": "apg"
},
"inputs": {
"audio": "https://assets.runware.ai/assets/inputs/1f61c8cd-e262-4a82-b4eb-6c4b0d6f1f76.mp3"
}
}
]'runware run runware:ace-step@v1.5-base \
positivePrompt="Transform the supplied musical source into a newly arranged Nordic electroacoustic documentary bed for a professional avalanche-rescue e-learning lesson. Preserve the source's recognizable five-note motif, harmonic movement, and measured pulse, but reorchestrate them with felt piano, bowed vibraphone, low cello harmonics, subtle granular wind textures, and a muted frame drum. The mood is focused, reassuring, and cold-clear rather than dramatic. Use spacious, modern public-broadcast production with restrained dynamics and seamless transitions. Keep the music beneath the voice and gently duck it during key instructions. Add one calm, authoritative adult female instructor speaking natural English with precise diction, moderate pacing, and no sung delivery. Narration, spoken verbatim: \"Before leaving the trailhead, switch every transceiver to send and complete a group check. If an avalanche occurs, move to a safe position, call emergency services, and switch every rescuer's beacon to search. Follow the direction and distance display quickly at first. Inside ten meters, slow down. Below three meters, keep the beacon close to the snow and use a careful cross pattern to find the lowest reading. Probe perpendicular to the surface. When you strike the victim, leave the probe in place and begin shoveling from downhill.\" End with a brief, resolved instrumental reprise of the source motif." \
negativePrompt="Singing, chanting, choir, theatrical acting, alarmist tone, action-movie percussion, loud music over speech, distorted narration, slurred words, excessive reverb, abrupt ending." \
strength=0.65 \
settings.guidanceType=apg \
inputs.audio=https://assets.runware.ai/assets/inputs/1f61c8cd-e262-4a82-b4eb-6c4b0d6f1f76.mp3{
"taskType": "audioInference",
"taskUUID": "d419ae88-b5e9-4c2e-ac78-f93f7de89aa7",
"model": "runware:ace-step@v1.5-base",
"positivePrompt": "Transform the supplied musical source into a newly arranged Nordic electroacoustic documentary bed for a professional avalanche-rescue e-learning lesson. Preserve the source's recognizable five-note motif, harmonic movement, and measured pulse, but reorchestrate them with felt piano, bowed vibraphone, low cello harmonics, subtle granular wind textures, and a muted frame drum. The mood is focused, reassuring, and cold-clear rather than dramatic. Use spacious, modern public-broadcast production with restrained dynamics and seamless transitions. Keep the music beneath the voice and gently duck it during key instructions. Add one calm, authoritative adult female instructor speaking natural English with precise diction, moderate pacing, and no sung delivery. Narration, spoken verbatim: \"Before leaving the trailhead, switch every transceiver to send and complete a group check. If an avalanche occurs, move to a safe position, call emergency services, and switch every rescuer's beacon to search. Follow the direction and distance display quickly at first. Inside ten meters, slow down. Below three meters, keep the beacon close to the snow and use a careful cross pattern to find the lowest reading. Probe perpendicular to the surface. When you strike the victim, leave the probe in place and begin shoveling from downhill.\" End with a brief, resolved instrumental reprise of the source motif.",
"negativePrompt": "Singing, chanting, choir, theatrical acting, alarmist tone, action-movie percussion, loud music over speech, distorted narration, slurred words, excessive reverb, abrupt ending.",
"strength": 0.65,
"settings": {
"guidanceType": "apg"
},
"inputs": {
"audio": "https://assets.runware.ai/assets/inputs/1f61c8cd-e262-4a82-b4eb-6c4b0d6f1f76.mp3"
}
}Response
{
"taskType": "audioInference",
"taskUUID": "d419ae88-b5e9-4c2e-ac78-f93f7de89aa7",
"audioUUID": "99be0d4b-9ecb-418c-8524-4ae824e16c89",
"audioURL": "https://am.runware.ai/audio/os/a08dlim3/ws/5/ai/99be0d4b-9ecb-418c-8524-4ae824e16c89.mp3",
"seed": 428370404,
"cost": 0.01635
}audio-extend
Coastal Lighting Retrofit Explainer Narration$0.0087~22s0:00
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'runware:ace-step@v1.5-base',
positivePrompt: 'Prepend a refined instrumental introduction that develops naturally into the supplied coastal infrastructure explainer. Match the source exactly in key, tempo, meter, instrumentation, mix perspective, and production character: A minor, 78 BPM, restrained industrial-documentary scoring with muted marimba, warm analog bass, brushed percussion, soft bowed cello harmonics, distant harbor air, and occasional understated buoy-bell color. Begin sparsely with harbor ambience and a single low marimba motif, then gradually introduce bass pulse, cello texture, and brushed rhythmic detail. Keep the mood calm, credible, modern, and quietly optimistic rather than cinematic or dramatic. Shape the final measures so the harmony, groove, ambience, loudness, and room tone flow seamlessly into the existing opening downbeat. The new introduction must remain instrumental, leaving the first spoken line of the source untouched and clearly intelligible when it begins.',
strength: 0.7,
settings: {
repaintingStart: -12,
repaintingEnd: 0,
guidanceType: 'apg'
},
inputs: {
audio: 'https://assets.runware.ai/assets/inputs/34c9c90e-b245-425a-bd40-91f696560181.mp3'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "runware:ace-step@v1.5-base",
"positivePrompt": "Prepend a refined instrumental introduction that develops naturally into the supplied coastal infrastructure explainer. Match the source exactly in key, tempo, meter, instrumentation, mix perspective, and production character: A minor, 78 BPM, restrained industrial-documentary scoring with muted marimba, warm analog bass, brushed percussion, soft bowed cello harmonics, distant harbor air, and occasional understated buoy-bell color. Begin sparsely with harbor ambience and a single low marimba motif, then gradually introduce bass pulse, cello texture, and brushed rhythmic detail. Keep the mood calm, credible, modern, and quietly optimistic rather than cinematic or dramatic. Shape the final measures so the harmony, groove, ambience, loudness, and room tone flow seamlessly into the existing opening downbeat. The new introduction must remain instrumental, leaving the first spoken line of the source untouched and clearly intelligible when it begins.",
"strength": 0.7,
"settings": {
"repaintingStart": -12,
"repaintingEnd": 0,
"guidanceType": "apg"
},
"inputs": {
"audio": "https://assets.runware.ai/assets/inputs/34c9c90e-b245-425a-bd40-91f696560181.mp3"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "audioInference",
"taskUUID": "e4a8aa82-b8fb-418e-b75d-e7ea6246ee97",
"model": "runware:ace-step@v1.5-base",
"positivePrompt": "Prepend a refined instrumental introduction that develops naturally into the supplied coastal infrastructure explainer. Match the source exactly in key, tempo, meter, instrumentation, mix perspective, and production character: A minor, 78 BPM, restrained industrial-documentary scoring with muted marimba, warm analog bass, brushed percussion, soft bowed cello harmonics, distant harbor air, and occasional understated buoy-bell color. Begin sparsely with harbor ambience and a single low marimba motif, then gradually introduce bass pulse, cello texture, and brushed rhythmic detail. Keep the mood calm, credible, modern, and quietly optimistic rather than cinematic or dramatic. Shape the final measures so the harmony, groove, ambience, loudness, and room tone flow seamlessly into the existing opening downbeat. The new introduction must remain instrumental, leaving the first spoken line of the source untouched and clearly intelligible when it begins.",
"strength": 0.7,
"settings": {
"repaintingStart": -12,
"repaintingEnd": 0,
"guidanceType": "apg"
},
"inputs": {
"audio": "https://assets.runware.ai/assets/inputs/34c9c90e-b245-425a-bd40-91f696560181.mp3"
}
}
]'runware run runware:ace-step@v1.5-base \
positivePrompt="Prepend a refined instrumental introduction that develops naturally into the supplied coastal infrastructure explainer. Match the source exactly in key, tempo, meter, instrumentation, mix perspective, and production character: A minor, 78 BPM, restrained industrial-documentary scoring with muted marimba, warm analog bass, brushed percussion, soft bowed cello harmonics, distant harbor air, and occasional understated buoy-bell color. Begin sparsely with harbor ambience and a single low marimba motif, then gradually introduce bass pulse, cello texture, and brushed rhythmic detail. Keep the mood calm, credible, modern, and quietly optimistic rather than cinematic or dramatic. Shape the final measures so the harmony, groove, ambience, loudness, and room tone flow seamlessly into the existing opening downbeat. The new introduction must remain instrumental, leaving the first spoken line of the source untouched and clearly intelligible when it begins." \
strength=0.7 \
settings.repaintingStart=-12 \
settings.repaintingEnd=0 \
settings.guidanceType=apg \
inputs.audio=https://assets.runware.ai/assets/inputs/34c9c90e-b245-425a-bd40-91f696560181.mp3{
"taskType": "audioInference",
"taskUUID": "e4a8aa82-b8fb-418e-b75d-e7ea6246ee97",
"model": "runware:ace-step@v1.5-base",
"positivePrompt": "Prepend a refined instrumental introduction that develops naturally into the supplied coastal infrastructure explainer. Match the source exactly in key, tempo, meter, instrumentation, mix perspective, and production character: A minor, 78 BPM, restrained industrial-documentary scoring with muted marimba, warm analog bass, brushed percussion, soft bowed cello harmonics, distant harbor air, and occasional understated buoy-bell color. Begin sparsely with harbor ambience and a single low marimba motif, then gradually introduce bass pulse, cello texture, and brushed rhythmic detail. Keep the mood calm, credible, modern, and quietly optimistic rather than cinematic or dramatic. Shape the final measures so the harmony, groove, ambience, loudness, and room tone flow seamlessly into the existing opening downbeat. The new introduction must remain instrumental, leaving the first spoken line of the source untouched and clearly intelligible when it begins.",
"strength": 0.7,
"settings": {
"repaintingStart": -12,
"repaintingEnd": 0,
"guidanceType": "apg"
},
"inputs": {
"audio": "https://assets.runware.ai/assets/inputs/34c9c90e-b245-425a-bd40-91f696560181.mp3"
}
}Response
{
"taskType": "audioInference",
"taskUUID": "e4a8aa82-b8fb-418e-b75d-e7ea6246ee97",
"audioUUID": "996390f1-d62c-4ff0-bb36-dc739b5387bd",
"audioURL": "https://am.runware.ai/audio/os/a09dlim3/ws/5/ai/996390f1-d62c-4ff0-bb36-dc739b5387bd.mp3",
"seed": 735280314,
"cost": 0.0087
}audio-repaint
Oyster Farm Insurance Explainer Voiceover$0.0115~30s0:00
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'runware:ace-step@v1.5-base',
positivePrompt: 'Replace only the designated interior region of the existing oyster-farm insurance explainer. Preserve the source narrator\'s calm female voice, intimate documentary delivery, tempo, loudness, room tone, and restrained prepared-piano score. Speak this copy clearly and verbatim, never sung: “Traditional coverage waits for an adjuster. Tidelock watches the water instead. When verified salinity or storm-surge thresholds threaten your lease, payment starts automatically—no damage inspection, no paperwork delay—so crews can reset cages, replace seed, and get the next tide working.” Create a noticeable but brand-compatible change beneath the narration: gradually submerge the existing piano into a tactile underwater soundscape of filtered buoy knocks, tiny shell clicks, hydrophone bubbles, and one warm bass swell. Keep every word intelligible and natural. Enter seamlessly from the preceding music, let the underwater texture bloom in the middle, then surface gradually and reconnect exactly with the following prepared piano, percussion, ambience, and narration. No abrupt edits, new intro, ending cadence, jingle, chorus, or announcer-style exaggeration.',
strength: 0.75,
settings: {
repaintingStart: 8,
repaintingEnd: 18,
guidanceType: 'cfg'
},
inputs: {
audio: 'https://assets.runware.ai/assets/inputs/d394af1a-68ad-40ac-a4d2-ee625d2585ce.mp3'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "runware:ace-step@v1.5-base",
"positivePrompt": "Replace only the designated interior region of the existing oyster-farm insurance explainer. Preserve the source narrator's calm female voice, intimate documentary delivery, tempo, loudness, room tone, and restrained prepared-piano score. Speak this copy clearly and verbatim, never sung: “Traditional coverage waits for an adjuster. Tidelock watches the water instead. When verified salinity or storm-surge thresholds threaten your lease, payment starts automatically—no damage inspection, no paperwork delay—so crews can reset cages, replace seed, and get the next tide working.” Create a noticeable but brand-compatible change beneath the narration: gradually submerge the existing piano into a tactile underwater soundscape of filtered buoy knocks, tiny shell clicks, hydrophone bubbles, and one warm bass swell. Keep every word intelligible and natural. Enter seamlessly from the preceding music, let the underwater texture bloom in the middle, then surface gradually and reconnect exactly with the following prepared piano, percussion, ambience, and narration. No abrupt edits, new intro, ending cadence, jingle, chorus, or announcer-style exaggeration.",
"strength": 0.75,
"settings": {
"repaintingStart": 8,
"repaintingEnd": 18,
"guidanceType": "cfg"
},
"inputs": {
"audio": "https://assets.runware.ai/assets/inputs/d394af1a-68ad-40ac-a4d2-ee625d2585ce.mp3"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "audioInference",
"taskUUID": "96513e32-4d82-40b0-8fa8-d6d0bc025e61",
"model": "runware:ace-step@v1.5-base",
"positivePrompt": "Replace only the designated interior region of the existing oyster-farm insurance explainer. Preserve the source narrator's calm female voice, intimate documentary delivery, tempo, loudness, room tone, and restrained prepared-piano score. Speak this copy clearly and verbatim, never sung: “Traditional coverage waits for an adjuster. Tidelock watches the water instead. When verified salinity or storm-surge thresholds threaten your lease, payment starts automatically—no damage inspection, no paperwork delay—so crews can reset cages, replace seed, and get the next tide working.” Create a noticeable but brand-compatible change beneath the narration: gradually submerge the existing piano into a tactile underwater soundscape of filtered buoy knocks, tiny shell clicks, hydrophone bubbles, and one warm bass swell. Keep every word intelligible and natural. Enter seamlessly from the preceding music, let the underwater texture bloom in the middle, then surface gradually and reconnect exactly with the following prepared piano, percussion, ambience, and narration. No abrupt edits, new intro, ending cadence, jingle, chorus, or announcer-style exaggeration.",
"strength": 0.75,
"settings": {
"repaintingStart": 8,
"repaintingEnd": 18,
"guidanceType": "cfg"
},
"inputs": {
"audio": "https://assets.runware.ai/assets/inputs/d394af1a-68ad-40ac-a4d2-ee625d2585ce.mp3"
}
}
]'runware run runware:ace-step@v1.5-base \
positivePrompt="Replace only the designated interior region of the existing oyster-farm insurance explainer. Preserve the source narrator's calm female voice, intimate documentary delivery, tempo, loudness, room tone, and restrained prepared-piano score. Speak this copy clearly and verbatim, never sung: “Traditional coverage waits for an adjuster. Tidelock watches the water instead. When verified salinity or storm-surge thresholds threaten your lease, payment starts automatically—no damage inspection, no paperwork delay—so crews can reset cages, replace seed, and get the next tide working.” Create a noticeable but brand-compatible change beneath the narration: gradually submerge the existing piano into a tactile underwater soundscape of filtered buoy knocks, tiny shell clicks, hydrophone bubbles, and one warm bass swell. Keep every word intelligible and natural. Enter seamlessly from the preceding music, let the underwater texture bloom in the middle, then surface gradually and reconnect exactly with the following prepared piano, percussion, ambience, and narration. No abrupt edits, new intro, ending cadence, jingle, chorus, or announcer-style exaggeration." \
strength=0.75 \
settings.repaintingStart=8 \
settings.repaintingEnd=18 \
settings.guidanceType=cfg \
inputs.audio=https://assets.runware.ai/assets/inputs/d394af1a-68ad-40ac-a4d2-ee625d2585ce.mp3{
"taskType": "audioInference",
"taskUUID": "96513e32-4d82-40b0-8fa8-d6d0bc025e61",
"model": "runware:ace-step@v1.5-base",
"positivePrompt": "Replace only the designated interior region of the existing oyster-farm insurance explainer. Preserve the source narrator's calm female voice, intimate documentary delivery, tempo, loudness, room tone, and restrained prepared-piano score. Speak this copy clearly and verbatim, never sung: “Traditional coverage waits for an adjuster. Tidelock watches the water instead. When verified salinity or storm-surge thresholds threaten your lease, payment starts automatically—no damage inspection, no paperwork delay—so crews can reset cages, replace seed, and get the next tide working.” Create a noticeable but brand-compatible change beneath the narration: gradually submerge the existing piano into a tactile underwater soundscape of filtered buoy knocks, tiny shell clicks, hydrophone bubbles, and one warm bass swell. Keep every word intelligible and natural. Enter seamlessly from the preceding music, let the underwater texture bloom in the middle, then surface gradually and reconnect exactly with the following prepared piano, percussion, ambience, and narration. No abrupt edits, new intro, ending cadence, jingle, chorus, or announcer-style exaggeration.",
"strength": 0.75,
"settings": {
"repaintingStart": 8,
"repaintingEnd": 18,
"guidanceType": "cfg"
},
"inputs": {
"audio": "https://assets.runware.ai/assets/inputs/d394af1a-68ad-40ac-a4d2-ee625d2585ce.mp3"
}
}Response
{
"taskType": "audioInference",
"taskUUID": "96513e32-4d82-40b0-8fa8-d6d0bc025e61",
"audioUUID": "7f5d2234-377f-483b-a810-415cd8aa58e6",
"audioURL": "https://am.runware.ai/audio/os/a04d20/ws/5/ai/7f5d2234-377f-483b-a810-415cd8aa58e6.mp3",
"seed": 1625051487,
"cost": 0.01155
}