Orders

Submit an order

Submit an AI audio editing order for one audio file: file_url, a direct public link, or upload_id from POST /orders/upload-url for a file that has no link. Give one of the two. The file must hold exactly one audio track; one with several is refused once it has been fetched (the order fails with the reason). A fetch that has to be tried again leaves the order in new for some minutes: keep polling. Free inside the account's allowance (600 AI minutes per 30 days; 30 until the account email is confirmed). Requires an idempotency key. order_id (the upload path before October 2026) is no longer accepted: 410 upload_id_required, or 403 link_orders_only while uploads are switched off. Human-edited orders through the API were retired in October 2026: editing_mode=human or order_type=video returns 410.

post/orders/submit

Request

  • Base URL: https://barevalue.com/api/v1
  • URL: https://barevalue.com/api/v1/orders/submit
  • Auth: HTTP bearer

Request body

file_urlstring uri

Direct public link to the audio file. Give this or upload_id.

upload_idstring

The upload_id from POST /orders/upload-url, once the file has been uploaded. Give this or file_url.

podcast_namestring required
episode_namestring required
episode_numberstring nullable

Digits only. A value that is not a whole number is ignored; the order is still accepted.

special_instructionsstring nullable

Editing instructions (e.g., 'Remove ums and ahs', 'Keep the intro music')

host_namesstring nullable

Comma-separated host names for speaker identification

guest_namesstring nullable

Comma-separated guest names for speaker identification

idempotency_keystring uuid nullable required

Required. A UUID. Resend the same value when retrying so the order is not created twice.

duration_minutesnumber

Optional. Audio length in minutes for a file_url order, if known. The real length is measured after download and billed.

Example request

{
  "podcast_name": "The Daily Edit",
  "episode_name": "Episode 42: Audio Quality Deep Dive",
  "episode_number": "42"
}

Response

Order submitted successfully

order_idinteger
status'pending' | 'processing'
estimated_completionstring date-time nullable

Estimated completion time

Changes

No recorded changes to this operation across all 1 revision of this API.