HopBase DocsRetrieve clone audio
Retrieve one unused uploaded file by `file_id`; free.
GET
/v1/files/retrieveOnly returns files you uploaded that are still valid; files already used for a clone or older than 24 hours return 404.
Headers
Authorization:requiredstring
Bearer sk-…: an API key created in the console under API keys; its group must include the requested model
Query parameters
file_id:requiredinteger
File ID returned at upload
Range≥ 1
Returns
200File info
file:optionalobject
Uploaded file
file_id:optionalinteger
File ID; pass it as file_id or clone_prompt.prompt_audio when cloning
bytes:optionalinteger
File size in bytes
created_at:optionalinteger
Upload time, Unix seconds
filename:optionalstring
File name
purpose:optionalstring
voice_clone or prompt_audio
Valuesvoice_cloneprompt_audio
base_resp:optionalobject
{"status_code": 0, "status_msg": "success"} on success; errors do not come here but as a non-200 status code with an error object
status_code:optionalinteger
0 on success
status_msg:optionalstring
success on success
Errors
400
file_id must be a positive integer401Missing, invalid or expired API key (
missing_api_key / invalid_api_key / api_key_expired)404File does not exist, was already used, or has expired:
file_id N does not exist503
file lookup is temporarily unavailable; please retry