API REFERENCE

AI Renamer

Convert raw scene descriptions into clean, standardized filenames using AI. Works from anywhere — scripts, bots, extensions, or any HTTP client.

Endpoint

POST/api/ai-rename

Takes one or more scene descriptions and returns properly formatted filenames. Supports multi-line input — each line is processed independently.

Request Body

Parameter	Type	Description
text*	string	Raw scene description(s). Multiple lines will each be renamed separately.

// Content-Type: application/json
{
  "text": "Luna Star -- @Brazzers -- Luna Gets Wild -- 2024-03-20"
}

Response

Field	Type	Description
ok	boolean	Whether the rename was successful
result	string	The formatted filename(s), one per line
error	string	Error message (only when ok is false)

{
  "ok": true,
  "result": "Brazzers.24.03.20.Luna.Star.Gets.Wild"
}

Output Format

Studio.YY.MM.DD.Performer.Name.Scene.Title.Words

// Examples:
"Brazzers.24.03.20.Luna.Star.Gets.Wild"
"Dogfart.BlacksOnBlondes.23.08.18.Scarlett.Alexis.Business.Opportunity"
"Vixen.24.03.15.Kendra.Sunderland.A.Perfect.Day"

Examples

cURL

curl -X POST https://fmt.helvetican.xyz/api/ai-rename \
  -H "Content-Type: application/json" \
  -d '{"text": "Vixen Kendra Sunderland A Perfect Day 03 15 24 2160p"}'

JavaScript

const res = await fetch('/api/ai-rename', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ text: 'your scene description' })
});
const { ok, result } = await res.json();
console.log(result);

Python

import requests
r = requests.post("https://fmt.helvetican.xyz/api/ai-rename", json={
  "text": "Vixen Kendra Sunderland A Perfect Day 03 15 24 2160p"
})
data = r.json()
print(data["result"])

PowerShell

$body = @{ text = "Vixen Kendra Sunderland A Perfect Day 03 15 24" } | ConvertTo-Json
Invoke-RestMethod -Uri "https://fmt.helvetican.xyz/api/ai-rename" `
  -Method POST -ContentType "application/json" -Body $body

Error Codes

Status	Reason	Description
400	Bad Request	Missing or empty text field, or invalid JSON body
500	Server Error	Missing API key, prompt load failure, or AI provider error