Book a specific voice
Description
Creates a new booking project to obtain a recording from a specific voice actor.
Arguments
= required = only one of these is requiredName | Type | Description | Default value |
---|---|---|---|
script | text | Text that will be read by voice actors. Write instructions inside of [ ]. They won't count towards the word/character total. If you want to receive multiple files, submit the different parts as a JSON array, naming the key of each element anyway you wish (see advanced example below). The name of each key will be used to name the audio files. | |
talentID | string | Unique identifier of the voice actor wanted for the project. | |
title | string | Descriptive text about the project of up to 50 characters. This text is the first reference that voice actors will have about your project. Using it wisely will help you attract more and better voice actors. | |
syncedRecording | integer | Set this argument to "1" if the recording needs to be synced. For example: synchronization with a video or presentation. The price of the project will be 50% higher. | 0 |
test | boolean | Set this argument to "1" to test this operation. When set to "1", the project won't affect your account balance and it will automatically get a fake read within 120 seconds. | 0 |
genderAndAge | string | Gender and age wanted for the read. Valid values can be obtained with the /genderAndAges operation. | |
language | string | Language (and regional accent) wanted for the read. Valid values can be obtained with the /languages operation. | |
ping | string | Use it to be notified as the project has new reads in status "reviewable". Possible values are: Empty: No notifications will be sent. "email": A message will be sent to your account's email address. A valid email address: A message will be sent to the given email address. A valid URL: The given URL will be called via a "get" request, expecting a 200, 201, or 202 response. You may use as many URL parameters as you need. | |
remarks | text | Use this field to provide additional information to the voice actors. For example: type of read (movie trailer voice, commercial, phone greeting, etc.), links to videos, links to other reads you like, links to other project, links to images, etc. Learn to provide great directions to voice actors. |
Errors
- 5002: Your account balance is too low and you don't have a credit card on file we can automatically charge. Please add funds or your credit card info at http://voicebunny.com/account
- 5005: The "title" argument cannot be empty. Please use a descriptive text about the project. This text is the first reference that voice actors will have about your project. Using it wisely will help you attract more and better voice actors.
- 5007: The "language" argument is not valid. You can get the list of available languages and accents using the API operation /languages.
- 5008: The "genderAndAge" argument is not valid. You can get the list of available "gender and ages" using the API operation /genderAndAges.
- 5009: The "script" argument cannot be empty.
- 5037: The "ping" argument should be an email address, an URL, "email", or be empty.
- 5039: The "lifetime" argument should be a positive number, or it should be empty.
- 5048: The "title" argument is too long. Please limit it to 100 characters.
- 5073: The "price" argument must be at or above Bunny Studios's suggested rate. Remember, better rewards attract better, faster voice actors.
- 5080: Some parts of the script are empty, please remove them or add some information.
- 5100: The "price" argument should be empty when posting projects with fulfillmentType = "booking". Projects of this type are not allowed to "name their own price" as VoiceBunny only offers fixed rates for each voice actor.
- 5102: The "talentID" argument is not valid.
- 5103: When fulfilmentType = booking, the 'talentID' argument should not be empty.
- 5104: When posting a project with fulfillmentType = 'booking' and test = '1', talentID should be 81SQO.
- 5106: Bummer! The talent you chose is not accepting bookings at this time. Please select another voice actor or Contact Bunny Studio for help.
- 5109: Bummer! The talent you chose will be away until {{date}}. Please Contact Bunny Studio for help.
- 5150: