Sound Effects v2
sound-effects-v2Use the Sound Effects V2 API for ai sound effects. Describe the sound in text and choose an available duration. Create audio cues, ambient effects, and sounds for a video or game. Compare the available provider routes, request examples, and usage prices on OpenAny.
- Published price
- From $0.002 / second
- Billing unit
- / second
- Context / Max output
- — / —
- Listed routes
- 1
Parameters are derived from this model's official contract. No live request has been made.
Result preview
yir · 47ms
Response example. Run to see the actual response.
{
"id": "string",
"urls": {
"get": "string",
"cancel": "string"
},
"error": {
"code": "YIR_INVALID_REQUEST",
"action": "fix_request",
"details": [
{
"field": "string",
"reason": "invalid_body",
"allowed": [
"string"
],
"expected": "string"
}
],
"message": "string",
"retryable": true,
"provider_error": {
"message": "string",
"provider": "string"
}
},
"model": "string",
"usage": {
"outputs": 0
},
"object": "job",
"result": {
"files": [
{
"url": "http://example.com",
"width": 0,
"height": 0,
"fidelity": {
"grade": "original",
"reason": "string"
},
"expires_at": 1,
"media_type": "string",
"duration_ms": 1
}
],
"warnings": [
"additional_results_unavailable"
],
"availability": "available",
"content_safety": {
"status": "passed",
"checked_by": "provider"
}
},
"status": "queued",
"billing": {
"status": "pending",
"currency": "USD",
"max_cost": "string",
"gateway_fee": {
"amount": "string",
"status": "settled"
},
"billing_mode": "actual",
"compute_charges": [
{
"usage": [
{
"unit": "string",
"metric": "string",
"quantity": "string"
}
],
"amount": "string",
"status": "settled",
"billed_by": "yir",
"supply_type": "managed",
"amount_basis": "yir_price_rule"
}
],
"official_comparison": {
"source_url": "http://example.com",
"savings_amount": "string",
"baseline_amount": "string"
},
"total_charged_by_yir": "string"
},
"created_at": 1,
"parameters": {
"n": 1,
"fps": 1,
"size": "string",
"voice": "string",
"quality": "string",
"duration": 1,
"resolution": "string",
"aspect_ratio": "string",
"instrumental": true,
"generate_audio": true,
"lyrics_optimizer": true
},
"cancellation": {
"effect": "stop_future_attempts",
"status": "cancelled",
"requested_at": 1
},
"completed_at": 1,
"final_provider": "string",
"parameter_notices": [
{
"name": "string",
"reason": "channel_parameter_unsupported",
"message": "string",
"disposition": "ignored"
}
]
}- Base URL
https://api.openany.si/v1- POST
/v1/audios- GET
/v1/audios/{task_id}- Authentication
Authorization: Bearer $OPENANY_API_KEY
Request parameters
| Parameter | Type / range | Default value | Required | Description |
|---|---|---|---|---|
prompt | string | A heavy wooden door creaking open in an empty stone hall | Yes | Prompt |
duration | integer · 1 ~ 22 | 5 | No | Output audio length in seconds; the price follows this length. |
n | integer · 1 1 ~ 1 | 1 | No | Number of outputs from one API request (one Job), not the application batch size. For multiple Jobs, submit separate requests; n=1 does not prevent application-managed batching. |
Request example
curl 'https://api.openany.si/v1/audios' \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "A heavy wooden door creaking open in an empty stone hall",
"type": "text"
},
"model": "sound-effects-v2",
"parameters": {
"duration": 5,
"n": 1
},
"route_mode": "balanced"
}'Response example
Official schema example with placeholders, not a live response
{
"id": "string",
"urls": {
"get": "string",
"cancel": "string"
},
"error": {
"code": "YIR_INVALID_REQUEST",
"action": "fix_request",
"details": [
{
"field": "string",
"reason": "invalid_body",
"allowed": [
"string"
],
"expected": "string"
}
],
"message": "string",
"retryable": true,
"provider_error": {
"message": "string",
"provider": "string"
}
},
"model": "string",
"usage": {
"outputs": 0
},
"object": "job",
"result": {
"files": [
{
"url": "http://example.com",
"width": 0,
"height": 0,
"fidelity": {
"grade": "original",
"reason": "string"
},
"expires_at": 1,
"media_type": "string",
"duration_ms": 1
}
],
"warnings": [
"additional_results_unavailable"
],
"availability": "available",
"content_safety": {
"status": "passed",
"checked_by": "provider"
}
},
"status": "queued",
"billing": {
"status": "pending",
"currency": "USD",
"max_cost": "string",
"gateway_fee": {
"amount": "string",
"status": "settled"
},
"billing_mode": "actual",
"compute_charges": [
{
"usage": [
{
"unit": "string",
"metric": "string",
"quantity": "string"
}
],
"amount": "string",
"status": "settled",
"billed_by": "yir",
"supply_type": "managed",
"amount_basis": "yir_price_rule"
}
],
"official_comparison": {
"source_url": "http://example.com",
"savings_amount": "string",
"baseline_amount": "string"
},
"total_charged_by_yir": "string"
},
"created_at": 1,
"parameters": {
"n": 1,
"fps": 1,
"size": "string",
"voice": "string",
"quality": "string",
"duration": 1,
"resolution": "string",
"aspect_ratio": "string",
"instrumental": true,
"generate_audio": true,
"lyrics_optimizer": true
},
"cancellation": {
"effect": "stop_future_attempts",
"status": "cancelled",
"requested_at": 1
},
"completed_at": 1,
"final_provider": "string",
"parameter_notices": [
{
"name": "string",
"reason": "channel_parameter_unsupported",
"message": "string",
"disposition": "ignored"
}
]
}Error handling
400Check the model ID and request fields.429Retry with exponential backoff.5xxRetry only temporary provider failures.Request example
POST /v1/audioscurl 'https://api.openany.si/v1/audios' \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "A heavy wooden door creaking open in an empty stone hall",
"type": "text"
},
"model": "sound-effects-v2",
"parameters": {
"duration": 5,
"n": 1
},
"route_mode": "balanced"
}'Model API questions
How do I call Sound Effects v2 through OpenAny?
Use model ID sound-effects-v2 with an OpenAny key and the operation published in this model's API tab. The model API base is https://api.openany.si/v1. Confirm the protocol and request schema; model availability does not imply every OpenAI API operation is supported.
How is Sound Effects v2 billed?
Compare the published rate and billing unit of the selected provider route. Input, output and cache token rates may differ. Image, audio and video models can use other units. Recorded usage determines the charge under that route's billing contract.
Are Community and Verified routes the same as an official publisher API?
No. Inspect the provider name and supply classification for the specific route. A marketplace listing or a supply label is not a claim of publisher endorsement, identical service or measured uptime. Different route prices may reflect different supply and conditions.
Where do these prices come from, and when were they updated?
Rates come from the provider routes in OpenAny's public model catalog, not an independent quote from the model publisher. The catalog does not supply a price update timestamp. A page or catalog snapshot date is not a price revision date. Compare supply, billing units, tiers and conditions; a lower listed rate alone does not establish equivalent service or explain the price difference.
Use Sound Effects v2 with your agent
Inspect endpoint contracts and confirm availability and pricing before a paid call.