Get Result API

Overview

The Get Result API retrieves a single AI record by its id.

Endpoint

GEThttps://api.1min.ai/api/results/:resultId

Authentication

Include your API key in the API-KEY header.

Path Parameters

Parameter	Type	Description
resultId	string	The uuid of the AI record returned by the AI Feature API. (There is no separate resultId field — the record's uuid is the result id.)

Request Example

JavaScript

fetch('https://api.1min.ai/api/results/120qae97-d77d-468d-9d78-2e7c0b2bbb98', {
  method: 'GET',
  headers: {
    'API-KEY': 'YOUR_API_KEY'
  }
})

cURL

curl --location 'https://api.1min.ai/api/results/120qae97-d77d-468d-9d78-2e7c0b2bbb98' \
--header 'API-KEY: YOUR_API_KEY'

Python

import requests

url = "https://api.1min.ai/api/results/120qae97-d77d-468d-9d78-2e7c0b2bbb98"
headers = {
"API-KEY": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers)

Response Payload

While Processing (200)

While the result is still being generated, status is "PROCESSING" and resultObject is empty:

{
  "aiRecord": {
    "uuid": "120qae97-d77d-468d-9d78-2e7c0b2bbb98",
    "userId": "75cz1a57-c969-47ac-9dc5-82941cdcfe57",
    "teamId": "595w4b41-dcc7-466f-8697-d4a919810b11",
    "model": "gpt-image-2",
    "type": "IMAGE_EDITOR",
    "metadata": null,
    "rating": null,
    "feedback": null,
    "conversationId": null,
    "status": "PROCESSING",
    "createdAt": "2024-09-30T03:47:29.738Z",
    "aiRecordDetail": {
      "promptObject": {
        "prompt": "Add a sunset background",
        "quality": "high"
      },
      "resultObject": []
    },
    "additionalData": null
  }
}

When Complete (200)

Once processing finishes, status is "SUCCESS" and resultObject contains the generated results. The response also includes a temporaryUrl — a signed, time-limited URL you can use to download the generated asset directly (the values in resultObject are relative storage keys, not downloadable URLs):

{
  "aiRecord": {
    "uuid": "120qae97-d77d-468d-9d78-2e7c0b2bbb98",
    "userId": "75cz1a57-c969-47ac-9dc5-82941cdcfe57",
    "teamId": "595w4b41-dcc7-466f-8697-d4a919810b11",
    "model": "gpt-image-2",
    "type": "IMAGE_EDITOR",
    "metadata": null,
    "rating": null,
    "feedback": null,
    "conversationId": null,
    "status": "SUCCESS",
    "createdAt": "2024-09-30T03:47:29.738Z",
    "aiRecordDetail": {
      "promptObject": {
        "prompt": "Add a sunset background",
        "quality": "high"
      },
      "resultObject": ["images/2024_09_30_03_47_31_072_210865.webp"]
    },
    "temporaryUrl": "https://storage.1min.ai/images/2024_09_30_03_47_31_072_210865.webp?X-Amz-Signature=...",
    "additionalData": null
  }
}

When Failure (200)

If processing fails, status is "FAILURE" and resultObject contains an error object describing what went wrong (the HTTP status is still 200 — check the status field, not the HTTP code):

{
  "aiRecord": {
    "uuid": "120qae97-d77d-468d-9d78-2e7c0b2bbb98",
    "userId": "75cz1a57-c969-47ac-9dc5-82941cdcfe57",
    "teamId": "595w4b41-dcc7-466f-8697-d4a919810b11",
    "model": "kling",
    "type": "VIDEO_GENERATOR",
    "metadata": null,
    "rating": null,
    "feedback": null,
    "conversationId": null,
    "status": "FAILURE",
    "createdAt": "2026-06-17T06:35:31.457Z",
    "aiRecordDetail": {
      "promptObject": {
        "mode": "std",
        "prompt": "a big is running\n\n",
        "version": "1.0",
        "duration": 5,
        "cfg_scale": 0.5,
        "aspect_ratio": "16:9",
        "camera_control_type": "default"
      },
      "resultObject": {
        "code": "PIAPI_TASK_RESPONSE_ERROR",
        "name": "ExternalError",
        "context": "{\"service\":\"piapi\"}",
        "details": "{}",
        "message": "The piapi service is a bit busy right now or facing a temporary issue. Please try again shortly. We appreciate your patience!",
        "traceId": "a9c68601366f6e79216d23cdf0571cdd",
        "errorSeverity": "high"
      }
    },
    "additionalData": null
  }
}

Not Found (200)

If the resultId is unknown — it doesn't exist, or it belongs to another team and isn't accessible with your API key — the endpoint still responds with 200 and aiRecord set to null:

{
  "aiRecord": null
}

Treat "aiRecord": null as an invalid or unknown id. This is distinct from a PROCESSING record, which returns a populated aiRecord with status: "PROCESSING".

Response Fields

aiRecord Object

Field	Type	Description
uuid	string	Unique identifier for the AI record (the result id)
userId	string	User identifier
teamId	string	Team identifier
model	string	Model used for processing
type	string	Feature type (e.g., IMAGE_EDITOR)
metadata	object	Additional metadata (nullable)
rating	number	User rating for the result (nullable)
feedback	string	User feedback text (nullable)
conversationId	string	Associated conversation ID (nullable)
status	string	Processing status: PROCESSING, SUCCESS, FAILURE
createdAt	string	Record creation timestamp (ISO 8601)
aiRecordDetail	object	Detailed request and response data
temporaryUrl	string	Signed, time-limited URL to download the generated asset. Present only on SUCCESS records.
additionalData	object	Extra data specific to feature (nullable)

aiRecordDetail Object

Field	Type	Description
promptObject	object	Original request parameters
resultObject	array | object	On SUCCESS, an array of generated results (URLs, text, etc.); empty while PROCESSING. On FAILURE, an error object (see below).

resultObject Error Object (on FAILURE)

Field	Type	Description
code	string	Machine-readable error code (e.g. PIAPI_TASK_RESPONSE_ERROR)
name	string	Error class name (e.g. ExternalError)
context	string	JSON string with additional context (e.g. the upstream service)
details	string	JSON string with extra error details
message	string	Human-readable error message
traceId	string	Trace identifier for support/debugging
errorSeverity	string	Severity of the error (e.g. low, medium, high)