JobCreated

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/scribiz/json-schema/scribiz-job-created-schema.json",
  "title": "JobCreated",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/scribiz-uploads-api-openapi.yml#/components/schemas/JobCreated",
  "properties": {
    "degraded": {
      "type": "object"
    },
    "estimate": {
      "$ref": "#/$defs/Quote"
    },
    "events_url": {
      "type": "string"
    },
    "idempotent_replay": {
      "type": "boolean"
    },
    "job_id": {
      "type": "string"
    },
    "mode": {
      "type": "string"
    },
    "queue_position": {
      "type": "integer"
    },
    "result_url": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "upload_id": {
      "type": "string"
    }
  },
  "required": [
    "job_id",
    "status",
    "events_url",
    "result_url",
    "estimate"
  ],
  "type": "object",
  "$defs": {
    "Quote": {
      "properties": {
        "cached": {
          "description": "Everything is already stored: nothing is charged.",
          "type": "boolean"
        },
        "caption_credits": {
          "description": "Maximum caption credits for a strict YouTube request. Media minutes are zero.",
          "minimum": 0,
          "type": "integer"
        },
        "charges_as": {
          "enum": [
            "caption-item",
            "captions",
            "audio",
            "visual",
            "full"
          ]
        },
        "length_known": {
          "const": false,
          "description": "Present (false) when the length of the source could not be read before the run (a YouTube link that yt-dlp and the YouTube page both refused; a direct media link not yet downloaded). The job is charged from the length it measures."
        },
        "max_media_seconds": {
          "description": "Only with `length_known: false` on a YouTube link: the longest stretch the job reads (a clip that ends there): never more than the plan allows per video and never more than the minutes left. `minutes` is the most the job can then use. When the server can get the video's own captions they answer instead, also for a longer video, and the job costs less.",
          "type": "number"
        },
        "media_seconds": {
          "description": "Seconds of media the quote is for; null when the length is not known (`length_known: false`).",
          "type": [
            "number",
            "null"
          ]
        },
        "minutes": {
          "description": "Minutes this job uses when it runs as quoted (0 when cached), including the half minute for each media minute when the full proofread is part of it (`proofread: \"full\"` or a `vocabulary`). It is charged only if the pass runs. With `length_known: false`: the most it can use.",
          "type": "number"
        },
        "tiers": {
          "items": {
            "enum": [
              "captions",
              "audio",
              "visual",
              "synthesis"
            ]
          },
          "type": "array"
        }
      },
      "required": [
        "minutes",
        "media_seconds",
        "tiers",
        "cached",
        "charges_as"
      ],
      "type": "object"
    }
  }
}