GET /v1/sound-effects/:id/certificate
Download the generation certificate PDF for a sound effect
Download the generation certificate for one of your sound effects — the same formal, single-page PDF as track certificates, issued by Riku AI LLC and confirming the sound effect was generated by you on Finetuning.
One certificate covers the whole sound-effect request; the title and duration on the certificate come from the request's first clip.
Request
GET https://pub.finetuning.ai/v1/sound-effects/:id/certificateThis endpoint was previously GET /v1/sound-effects/:id/license. The old path still works and returns exactly the same PDF — new integrations should use /certificate.
Headers
| Header | Type | Required | Description |
|---|---|---|---|
X-API-Key | string | Yes | Your API key |
Path parameters
| Parameter | Type | Description |
|---|---|---|
id | string | The sound effect ID (e.g., sfx_abc123) |
Example
curl https://pub.finetuning.ai/v1/sound-effects/sfx_abc123/certificate \
-H "X-API-Key: ft_live_your_key_here" \
-o certificate.pdfThe X-API-Key header is required, so this URL isn't clickable in a browser — pasting it into the address bar returns 401. It's an endpoint for your code.
Response
The response body is the PDF binary (Content-Type: application/pdf); the filename in Content-Disposition carries the certificate number. The certificate lists the AI model as Stable Audio, includes the prompt and requested settings, and carries the same permanent certificate number and public verification link as track certificates — see track certificates for the full contents.
Unlike music and instrumental tracks, sound effects have no certificate flag at creation — there's nothing to opt into. Request the PDF from this endpoint whenever you need it, for as long as the sound effect exists. See Certificates.
Errors
Errors are returned as JSON in the standard error shape.
| Code | Status | Description |
|---|---|---|
MISSING_API_KEY | 401 | X-API-Key header was not provided |
INVALID_API_KEY | 401 | API key is malformed, revoked, or does not exist |
NOT_READY | 400 | The sound effect is not completed yet |
PAID_PLAN_REQUIRED | 403 | Certificates require a Plus, Pro, or Lifetime plan |
NOT_FOUND | 404 | No sound effect with this ID in your account |
INTERNAL_ERROR | 500 | Unexpected server error |