{
  "schema": "https://miscsubjects.com/schemas/jarticle.json",
  "status": "published",
  "slug": "higgsfield-gpt-image-2-5",
  "title": "GPT Image 2.5",
  "kind": "model",
  "visibility": "public",
  "facts": {
    "provider": "higgsfield",
    "model_provider": "OpenAI",
    "modality": "image",
    "model_id": "gpt_image_2_5",
    "rules": {
      "transport": "http",
      "method": "POST",
      "endpoint": "https://fnf-api-gw.higgsfield.ai/fnf/developer/v2alpha/images/gpt_image_2_5/generations",
      "workspace_id": "ee057f86-ccb4-431a-ae22-b4a83589e040",
      "auth": {
        "graph_header": "X-Terminal-Key",
        "provider": "server-held Higgsfield OAuth access and refresh tokens; Hf-Workspace-Id",
        "browser_session": false,
        "plugin_tools": false
      },
      "request_shape": {
        "params": "fields below; prompt equals task spec"
      },
      "fields": {
        "prompt": {
          "type": "string",
          "required": true
        },
        "variant": {
          "type": "string",
          "enum": [
            "flare",
            "sunburst"
          ],
          "default": "flare"
        },
        "quality": {
          "type": "string",
          "enum": [
            "low",
            "medium",
            "high",
            "xhigh",
            "max"
          ],
          "default": "low"
        },
        "resolution": {
          "type": "string",
          "enum": [
            "1k",
            "2k",
            "4k"
          ],
          "default": "1k"
        },
        "aspect_ratio": {
          "type": "string",
          "enum": [
            "auto",
            "1:1",
            "3:2",
            "2:3",
            "4:3",
            "3:4",
            "16:9",
            "9:16",
            "21:9",
            "27:16",
            "16:27",
            "9:8",
            "8:9",
            "4:5",
            "5:4"
          ],
          "default": "1:1"
        },
        "background": {
          "type": "string",
          "nullable": true,
          "enum": [
            "auto",
            "opaque",
            "transparent"
          ]
        },
        "image_references": {
          "type": "array",
          "max": 16,
          "items": {
            "id": "uploaded media UUID",
            "type": "media_input"
          }
        }
      },
      "result_hosts": [
        "cloudfront.net",
        "higgsfield.ai"
      ],
      "lifecycle": {
        "status_endpoint": "https://fnf-api-gw.higgsfield.ai/fnf/developer/v2alpha/jobs/{id}",
        "success_state": "completed",
        "output_url_path": "result_url"
      },
      "cost_per_unit": {
        "credits": 0.25,
        "controls": {
          "variant": "flare",
          "quality": "low",
          "resolution": "1k"
        },
        "quote_endpoint": "https://fnf-api-gw.higgsfield.ai/fnf/developer/v2alpha/jobs/gpt_image_2_5/cost"
      },
      "source": "https://fnf-api-gw.higgsfield.ai/fnf/developer/v2alpha/job_types/gpt_image_2_5"
    }
  },
  "body": [
    {
      "type": "json",
      "title": "Rules",
      "ref": "#facts.rules"
    }
  ],
  "type": "article",
  "created": "2026-11-05T22:11:00.192Z",
  "updated": "2026-11-06T00:31:54.664Z",
  "version": 3,
  "hash": "cb443fd4c07f2fa13f89853e70a0de22af749dbd320b0bd59d9bb1f035776a80",
  "theme": "https://miscsubjects.com/article-theme.json",
  "styling": {
    "scope": "shared",
    "theme_ref": "https://miscsubjects.com/article-theme.json"
  },
  "page": "https://miscsubjects.com/a/higgsfield-gpt-image-2-5",
  "json": "https://miscsubjects.com/a/higgsfield-gpt-image-2-5.json",
  "markdown": "https://miscsubjects.com/a/higgsfield-gpt-image-2-5.md",
  "calls": [
    {
      "what": "this article as a page (no key)",
      "method": "GET",
      "url": "https://miscsubjects.com/a/higgsfield-gpt-image-2-5",
      "headers": {}
    },
    {
      "what": "this article as its object (no key)",
      "method": "GET",
      "url": "https://miscsubjects.com/a/higgsfield-gpt-image-2-5.json",
      "headers": {}
    },
    {
      "what": "this article as Markdown (no key)",
      "method": "GET",
      "url": "https://miscsubjects.com/a/higgsfield-gpt-image-2-5.md",
      "headers": {}
    },
    {
      "what": "the object with its hash, drafts too",
      "method": "GET",
      "url": "https://miscsubjects.com/api/jarticles/higgsfield-gpt-image-2-5",
      "headers": {
        "x-terminal-key": "<YOUR_TERMINAL_KEY>"
      }
    },
    {
      "what": "one piece and that piece’s hash",
      "method": "GET",
      "url": "https://miscsubjects.com/api/jarticles/higgsfield-gpt-image-2-5/at?path=facts",
      "headers": {
        "x-terminal-key": "<YOUR_TERMINAL_KEY>"
      }
    },
    {
      "what": "grep: every key or value that matches, with the path to change it",
      "method": "GET",
      "url": "https://miscsubjects.com/api/jarticles/higgsfield-gpt-image-2-5/grep?q=owner",
      "headers": {
        "x-terminal-key": "<YOUR_TERMINAL_KEY>"
      }
    },
    {
      "what": "change pieces (set, merge, delete, append, insert, move); if-match is the hash",
      "method": "PATCH",
      "url": "https://miscsubjects.com/api/jarticles/higgsfield-gpt-image-2-5",
      "headers": {
        "x-terminal-key": "<YOUR_TERMINAL_KEY>",
        "content-type": "application/json",
        "if-match": "<hash from the read>"
      },
      "body": {
        "ops": [
          {
            "op": "set",
            "path": "facts.example",
            "value": 1
          }
        ]
      }
    },
    {
      "what": "replace the whole object",
      "method": "PUT",
      "url": "https://miscsubjects.com/api/jarticles/higgsfield-gpt-image-2-5",
      "headers": {
        "x-terminal-key": "<YOUR_TERMINAL_KEY>",
        "content-type": "application/json",
        "if-match": "<hash>"
      },
      "body": {
        "slug": "higgsfield-gpt-image-2-5",
        "title": "…"
      }
    },
    {
      "what": "fetch every source, hash what came back and check the quote is in it",
      "method": "POST",
      "url": "https://miscsubjects.com/api/jarticles/higgsfield-gpt-image-2-5/verify",
      "headers": {
        "x-terminal-key": "<YOUR_TERMINAL_KEY>",
        "content-type": "application/json"
      },
      "body": {}
    },
    {
      "what": "an Obsidian-style command",
      "method": "POST",
      "url": "https://miscsubjects.com/api/jarticles/cli",
      "headers": {
        "x-terminal-key": "<YOUR_TERMINAL_KEY>",
        "content-type": "application/json"
      },
      "body": {
        "command": "backlinks",
        "file": "higgsfield-gpt-image-2-5"
      }
    }
  ],
  "entities": {
    "higgsfield-gpt-image-2-5": {
      "id": "higgsfield-gpt-image-2-5",
      "label": "GPT Image 2.5",
      "type": "model",
      "page": "https://miscsubjects.com/a/higgsfield-gpt-image-2-5",
      "json": "https://miscsubjects.com/a/higgsfield-gpt-image-2-5.json"
    },
    "cyrus-image-task-20261105": {
      "id": "cyrus-image-task-20261105",
      "label": "Make an image of Cyrus Massoumi",
      "type": "task",
      "page": "https://miscsubjects.com/a/cyrus-image-task-20261105",
      "json": "https://miscsubjects.com/a/cyrus-image-task-20261105.json"
    },
    "image-24827a1b-6bc6-40c9-b1b6-307861c13143-0": {
      "id": "image-24827a1b-6bc6-40c9-b1b6-307861c13143-0",
      "label": "Make an image of Cyrus Massoumi — image 1",
      "type": "image",
      "page": "https://miscsubjects.com/a/image-24827a1b-6bc6-40c9-b1b6-307861c13143-0",
      "json": "https://miscsubjects.com/a/image-24827a1b-6bc6-40c9-b1b6-307861c13143-0.json",
      "source_url": "https://miscsubjects.com/a/image-24827a1b-6bc6-40c9-b1b6-307861c13143-0/file"
    },
    "image-peace-sign-20261105-0": {
      "id": "image-peace-sign-20261105-0",
      "label": "Make a new AI clone image of Cyrus Massoumi throwing a peace sign — image 1",
      "type": "image",
      "page": "https://miscsubjects.com/a/image-peace-sign-20261105-0",
      "json": "https://miscsubjects.com/a/image-peace-sign-20261105-0.json",
      "source_url": "https://muse.ai/files/1296120066923726/1046558758449970/esc2ukzewsctucpq6s31cvbe/media-generation-cyrus-peace-sign-0-4ddd7ed1-33a3-46ea-82c4-cef65141b590.png"
    },
    "task-clone-peace-sign-20261105": {
      "id": "task-clone-peace-sign-20261105",
      "label": "Make a new AI clone image of Cyrus Massoumi throwing a peace sign",
      "type": "task",
      "page": "https://miscsubjects.com/a/task-clone-peace-sign-20261105",
      "json": "https://miscsubjects.com/a/task-clone-peace-sign-20261105.json"
    }
  },
  "relationships": {
    "upward": {
      "total": 0,
      "offset": 0,
      "limit": 50,
      "items": [],
      "next": null
    },
    "downward": {
      "total": 0,
      "offset": 0,
      "limit": 50,
      "items": [],
      "next": null
    },
    "sideways": {
      "total": 4,
      "offset": 0,
      "limit": 50,
      "items": [
        {
          "subject": "cyrus-image-task-20261105",
          "predicate": "uses",
          "object": "higgsfield-gpt-image-2-5",
          "asserted_by": "cyrus-image-task-20261105",
          "asserted_at": "facts.relations",
          "evidence": null,
          "valid_from": null,
          "valid_to": null,
          "temporal_scope": null,
          "as_of": null,
          "inverse_predicate": null,
          "source_json": "/a/cyrus-image-task-20261105.json",
          "ref": "cyrus-image-task-20261105"
        },
        {
          "subject": "image-24827a1b-6bc6-40c9-b1b6-307861c13143-0",
          "predicate": "attached_to",
          "object": "higgsfield-gpt-image-2-5",
          "asserted_by": "image-24827a1b-6bc6-40c9-b1b6-307861c13143-0",
          "asserted_at": "facts.relations",
          "evidence": null,
          "valid_from": null,
          "valid_to": null,
          "temporal_scope": null,
          "as_of": null,
          "inverse_predicate": null,
          "source_json": "/a/image-24827a1b-6bc6-40c9-b1b6-307861c13143-0.json",
          "ref": "image-24827a1b-6bc6-40c9-b1b6-307861c13143-0"
        },
        {
          "subject": "image-peace-sign-20261105-0",
          "predicate": "attached_to",
          "object": "higgsfield-gpt-image-2-5",
          "asserted_by": "image-peace-sign-20261105-0",
          "asserted_at": "facts.relations",
          "evidence": null,
          "valid_from": null,
          "valid_to": null,
          "temporal_scope": null,
          "as_of": null,
          "inverse_predicate": null,
          "source_json": "/a/image-peace-sign-20261105-0.json",
          "ref": "image-peace-sign-20261105-0"
        },
        {
          "subject": "task-clone-peace-sign-20261105",
          "predicate": "uses",
          "object": "higgsfield-gpt-image-2-5",
          "asserted_by": "task-clone-peace-sign-20261105",
          "asserted_at": "facts.relations",
          "evidence": null,
          "valid_from": null,
          "valid_to": null,
          "temporal_scope": null,
          "as_of": null,
          "inverse_predicate": null,
          "source_json": "/a/task-clone-peace-sign-20261105.json",
          "ref": "task-clone-peace-sign-20261105"
        }
      ],
      "next": null
    },
    "references": {
      "total": 0,
      "offset": 0,
      "limit": 50,
      "items": [],
      "next": null
    },
    "referenced_by": {
      "total": 4,
      "offset": 0,
      "limit": 50,
      "items": [
        {
          "ref": "cyrus-image-task-20261105",
          "predicate": "references",
          "subject": "cyrus-image-task-20261105",
          "object": "higgsfield-gpt-image-2-5"
        },
        {
          "ref": "image-24827a1b-6bc6-40c9-b1b6-307861c13143-0",
          "predicate": "references",
          "subject": "image-24827a1b-6bc6-40c9-b1b6-307861c13143-0",
          "object": "higgsfield-gpt-image-2-5"
        },
        {
          "ref": "image-peace-sign-20261105-0",
          "predicate": "references",
          "subject": "image-peace-sign-20261105-0",
          "object": "higgsfield-gpt-image-2-5"
        },
        {
          "ref": "task-clone-peace-sign-20261105",
          "predicate": "references",
          "subject": "task-clone-peace-sign-20261105",
          "object": "higgsfield-gpt-image-2-5"
        }
      ],
      "next": null
    }
  },
  "hierarchy": {
    "paths": [],
    "order": "subject to parent to ancestor",
    "complete": true,
    "cycles": [],
    "limits": {
      "depth": 12,
      "objects": 250
    },
    "unresolved_refs": []
  },
  "reference_contract": {
    "canonical_id": "slug",
    "entity_lookup": "entities[ref]; # resolves to this object via self_ref",
    "self_ref": "higgsfield-gpt-image-2-5",
    "entity_fields": "page and json are canonical object links; source_url is the external source",
    "directions": {
      "upward": "Parents and collections containing this object; predicate distinguishes location from membership.",
      "downward": "Objects naming this object as their parent, container or collection.",
      "sideways": "Associations and objects sharing a direct parent.",
      "references": "Objects referenced by this record.",
      "referenced_by": "Published articles referencing this record."
    },
    "predicates": {
      "part_of": "Declared parent hierarchy.",
      "located_in": "Location asserted on this object.",
      "associated_parcel": "Associated parcel, a separate object with its own jurisdiction and facts.",
      "member_of": "Collection membership, not geographic containment.",
      "included_in": "Editorial nesting, not geographic containment.",
      "shares_parent": "Shares the identified parent; no other relationship is implied.",
      "related_to": "An association with no more specific predicate recorded."
    },
    "scope": "Published article objects; Atlas inventories have their own counted, paged links. An association does not transfer facts or jurisdiction. An absent neighborhood means no neighborhood relationship is recorded."
  },
  "hash_spec": {
    "algorithm": "sha256",
    "encoding": "lowercase hexadecimal",
    "scope": "stored record; hash is also the write concurrency token",
    "included_keys": [
      "body",
      "created",
      "facts",
      "kind",
      "schema",
      "slug",
      "status",
      "title",
      "type",
      "updated",
      "version",
      "visibility"
    ],
    "field_overrides": {
      "schema": "jarticle/1"
    },
    "canonicalization": "Select included_keys from this response, apply field_overrides, recursively sort object keys using JavaScript Object.keys().sort(), retain array order, serialize primitives with JSON.stringify, join without whitespace, hash UTF-8 bytes.",
    "updated_included": true,
    "generated_fields": "All fields absent from included_keys are excluded. Relationship counts and theme references are generated and can change without changing the stored-record hash."
  }
}