Skip to main content
GET
/
api
/
v2
/
user
/
history
Generation History
curl --request GET \
  --url https://api.example.com/api/v2/user/history

Query Parameters

page
integer
default:"1"
Page number.
limit
integer
default:"20"
Items per page (max 100).
category
string
Filter: text, image, video, tts, stt, tool
model_slug
string
Filter by model slug.
status
string
Filter: completed, pending, failed
favorites_only
boolean
Show only favorited generations.

Request

curl "https://neuralbox.top/api/v2/user/history?category=image&limit=10" \
  -H "Authorization: Bearer nb_YOUR_API_KEY"

Response

{
  "items": [
    {
      "id": 18491,
      "model_slug": "flux-1.1-pro",
      "model_name": "Flux 1.1 Pro",
      "category": "image",
      "prompt": "Portrait of a CEO in a modern office",
      "status": "completed",
      "result_text": null,
      "result_url": "https://storage.neuralbox.top/generations/18491.webp",
      "tokens_spent": 8,
      "is_favorited": false,
      "user_rating": null,
      "created_at": "2026-03-08T12:02:30Z"
    }
  ],
  "total": 142,
  "page": 1,
  "limit": 10
}

Toggle Favorite

POST /api/v2/user/history/{generation_id}/favorite

Rate a Generation

POST /api/v2/user/history/{generation_id}/rate
Content-Type: application/json

{"rating": 5}

Delete

DELETE /api/v2/user/history/{generation_id}
File retention depends on your plan: Starter 7 days, Basic 30 days, Pro/VIP 90 days, Elite unlimited.