Media Upload
Convert Upload
Registers an uploaded file with OnlyFans and returns it ready to attach to a message. The account's upload settings and watermark are applied for you. Step 5 of Uploading Media. Requires permission api_media_upload.
https://public-api.fansmetric.comAuthorization
defaultAuthorizationBearer <token>Send your FansMetric API key as a Bearer token in the Authorization header.
In: header
Path Parameters
account_id*integerOnlyFans numeric account ID.
Request Body
application/jsonkey*stringThe
keyfrom the Create Signed Upload answer.uploadToken*stringuploadTokenfrom the Create Signed Upload answer.putUrl*stringThe address you sent the file to. For a file in pieces, the first piece's
putUrl.ETag*stringOne piece: the
ETagheader from sending the file, which is also the file's MD5. Pieces: theETagfrom Finish Multipart Upload. Double quotes are optional.contentType*stringThe file type you gave Create Signed Upload, such as
image/jpeg. It decides which of the account's watermark settings applies.namestringThe file name OnlyFans keeps. Defaults to the name at the end of
key.
Response Fields
dataobjectThe file, ready to attach: put it in
mediaFilesof Send Message or Send Mass Message as it is.data.processIdstringOnlyFans's reference for the file while it is processed. Pass it back unchanged.
data.hoststringPass it back unchanged.
data.namestringThe file name.
data.extrastringPass it back unchanged.
_meta._credits.usedintegerCredits consumed by this request (currently always
1)._meta._rate_limits.limit_minuteintegerMaximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteintegerRemaining requests in the current minute window.
_meta._rate_limits.limit_dayintegerMaximum requests per day for the organization.
_meta._rate_limits.remaining_dayintegerRemaining requests in the current day window.
| Field | Type | Description |
|---|---|---|
| data | object | The file, ready to attach: put it in mediaFiles of Send Message or Send Mass Message as it is. |
| data.processId | string | OnlyFans's reference for the file while it is processed. Pass it back unchanged. |
| data.host | string | Pass it back unchanged. |
| data.name | string | The file name. |
| data.extra | string | Pass it back unchanged. |
| _meta._credits.used | integer | Credits consumed by this request (currently always 1). |
| _meta._rate_limits.limit_minute | integer | Maximum requests per minute for the organization. |
| _meta._rate_limits.remaining_minute | integer | Remaining requests in the current minute window. |
| _meta._rate_limits.limit_day | integer | Maximum requests per day for the organization. |
| _meta._rate_limits.remaining_day | integer | Remaining requests in the current day window. |
curl --request POST "https://public-api.fansmetric.com/v1/100000001/upload/convert" \
--header "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"key": "upload/111222333/8a3d4c2e-7f1b-4c5d-9e8f-1a2b3c4d5e6f/529838163914/photo.jpg",
"uploadToken": "def456...",
"putUrl": "https://of2transcoder.s3-accelerate.amazonaws.com/upload/111222333/8a3d4c2e-.../529838163914/photo.jpg?X-Amz-Signature=...",
"ETag": "\"d41d8cd98f00b204e9800998ecf8427e\"",
"contentType": "image/jpeg"
}'Response
200Behavior
Upstream OnlyFans endpoint: POST https://convert.onlyfans.com/file/upload.
Registering doesn't put the file in the vault — it gets there once it's sent in a message. See Uploading Media.
Where this fits: Uploading Media.
400when a field is missing or has the wrong type — the message says which400withInvalid input.whenkeyoruploadTokendoesn't match the upload — use thekeyfrom the Create Signed Upload answer