Add casting projects
Description
Creates a new casting project to obtain three auditions quickly so you can pick a winner and have him/her record the full script. VoiceBunny will try to obtain the best auditions for the project given the price and lifetime of the project (see quickstart and flowchart).
Arguments
= required = only one of these is requiredName | Type | Description | Default value |
---|---|---|---|
auditionScript | string | Text that will be read for the audition by voice actors. Keep it short to attract better, faster voice actor. Write instructions inside of [ ]. They won't count towards the word/character total. | |
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. | |
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. | |
genderAndAge | string | Gender and age wanted for the read. Valid values can be obtained with the /genderAndAges operation. | middleAgeMale |
language | string | Language (and regional accent) wanted for the read. Valid values can be obtained with the /languages operation. | eng-us |
lifetime | integer | Lifetime of the casting process in seconds. VoiceBunny will try to get all auditions within this timeframe. Longer lifetimes will give VoiceBunny more time to find a great voice, as voice actors with higher ratings will have more time to accept the project. Shorter lifetimes will force VoiceBunny to open up the project to voice actors with lower ratings. You can compensate lower lifetimes with higher rewards (see price). | 84600 seconds (1 day) |
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 |
excludePrevious | integer | Number of your previous projects to be considered for excluding certain voice actors from working on this project. Use it to avoid getting the same voices you have received for your previous projects. | |
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. | |
price | float | Price paid for the project. If left empty, VoiceBunny will automatically set its default rates. You can learn in advanced what the value will be using the /projects/quote operation. Offering a higher price will attract our best voice actor to your project much faster. If you want help setting the price, contact Mr. VoiceBunny. | |
prioritizeFavoriteListID | integer | Set this argument to any FavoriteListID to give priority to the talents that have been added to it | |
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.
- 5011: The "price" argument should be empty or it should be a positive float number.
- 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.
- 5081: The "auditionScript" argument cannot be empty.
- 5150:
- 5152: The "excludePrevious" should be empty or it should be a positive integer number.
- 5178: The value for "prioritizeFavoriteListID" is not valid. Please provide a valid FavoriteListID.