Odile Labs

The offer for an After Hours AI phone receptionist on the owner's own business line, prepaid and billed per ANSWERED call: calls10: 10 calls for $15; calls50: 50 calls for $75 ($1.50 a call). A call is charged only when your line answers a real phone call and it lasts 20 seconds or more. Not charged: calls under that, robocalls the line recognises, calls from your own numbers or from ours, website and widget chats, text messages, and any call whose transcript cannot be read. At zero the line keeps answering. Up to 10 calls past zero are carried over and taken from your next pack. You are emailed at 3 calls left, at zero, and at 10 calls past zero. The line is never switched off automatically; past that, Odile Labs may pause it by hand after emailing you. Offered in: US. Use it before set_up_answering_line, to tell the owner exactly what they would buy. Needs no sign-in, reads no account and changes nothing. Returns { product, packs[{id, calls, cents}], per_call_cents, min_billable_seconds, answered_call_rule, at_zero, countries[], owner_must[], terms_url, set_up_with, top_up_with }.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Starts an After Hours AI receptionist for the signed-in owner's business, prepaid and billed per answered call (calls10: 10 calls for $15; calls50: 50 calls for $75). A call is charged only when your line answers a real phone call and it lasts 20 seconds or more. Not charged: calls under that, robocalls the line recognises, calls from your own numbers or from ours, website and widget chats, text messages, and any call whose transcript cannot be read. Nothing is built or bought until the owner pays: this returns a Stripe checkout link for the first pack, and the line (agent and phone number) is set up automatically once that is paid; its number and forwarding codes are then emailed to the account's address. Only call it after showing the owner https://odilelabs.com/terms and getting a yes. For prices first use get_answering_line_offer; for a line that already exists use get_answering_line, and add calls to it with buy_pack (product 'calls'), not a second set-up. United States only (the business line and the owner's mobile must be US numbers). Needs a signed-in connection with the lines:manage permission; limited to 3 set-ups a day per account. Returns { setup_id, status: 'awaiting payment', business_name, business_phone, pack, calls, price_cents, checkout_url, then }.

{
  "type": "object",
  "properties": {
    "business_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "The business name callers should hear, e.g. \"Alvarez Plumbing\"."
    },
    "business_phone": {
      "type": "string",
      "maxLength": 40,
      "description": "The business number callers dial today (US, with area code). The owner forwards it to the new line."
    },
    "owner_mobile": {
      "type": "string",
      "maxLength": 40,
      "description": "The owner's own mobile (US, with area code): their calls to the line are never charged."
    },
    "description": {
      "description": "What the business does, in one line; this is what it tells callers.",
      "type": "string",
      "maxLength": 300
    },
    "city": {
      "description": "The town the business is in, e.g. \"Wellington, FL\". The receptionist says it when a caller asks where you are.",
      "type": "string",
      "maxLength": 80
    },
    "services": {
      "description": "Up to 12 services, e.g. [\"drain cleaning\", \"water heaters\"].",
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 80
      }
    },
    "hours": {
      "description": "Opening hours by day name, e.g. {\"Monday\": {\"open\": \"8:00 AM\", \"close\": \"5:00 PM\"}, \"Sunday\": \"closed\"}. A day left out is closed. Omit entirely for Monday to Friday, 9 to 5.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "open": {
                "type": "string",
                "maxLength": 12
              },
              "close": {
                "type": "string",
                "maxLength": 12
              }
            },
            "required": [
              "open",
              "close"
            ]
          },
          {
            "type": "string",
            "const": "closed"
          }
        ]
      }
    },
    "languages": {
      "description": "Languages besides English the receptionist switches to when a caller does.",
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "es",
          "pt",
          "fr",
          "tr",
          "ru",
          "de"
        ]
      }
    },
    "extra": {
      "description": "Anything else the receptionist should know.",
      "type": "string",
      "maxLength": 600
    },
    "pack": {
      "type": "string",
      "enum": [
        "calls10",
        "calls50"
      ],
      "description": "The first pack: calls10: 10 calls for $15; calls50: 50 calls for $75."
    },
    "country": {
      "description": "Only US for now.",
      "type": "string",
      "enum": [
        "US"
      ]
    },
    "owner_confirmed_terms": {
      "type": "boolean",
      "description": "true ONLY after you showed the owner https://odilelabs.com/terms and they said yes. Anything else is refused."
    }
  },
  "required": [
    "business_name",
    "business_phone",
    "owner_mobile",
    "pack",
    "owner_confirmed_terms"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The signed-in owner's own After Hours lines billed per answered call, and any set-up still awaiting payment. Use it after set_up_answering_line to see when the line is live, to give the owner the forwarding codes, or to answer 'how many calls do I have left?'. Needs a signed-in connection with the lines:manage permission and changes nothing. Returns { lines[{ line_id, business_name, status (setting up | live | queued), number, number_e164, forwarding[{carrier, codes[{what, dial, stop}], note}], balance (calls left; below zero means carried over to the next pack), calls_charged_this_month, calls_charged_total, recent_calls[{at, seconds, message_taken, caller_last4}] }], pending[{ setup_id, business_name, status: 'awaiting payment', pack, started_at }] }. Callers are shown by their last four digits only.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Odile Labs' published benchmark of AI phone receptionists: real test calls placed to public lines, scored against stated measures. Use it when someone asks how AI receptionists actually handle calls, or to compare named products; call it with no arguments first, then filter. Needs no sign-in and changes nothing. Returns { source, date, calls, minutes, run_by, limitations, fairness_note, scenarios[{id,name,brief}], lines[{id, vendor, business, kind, answers_as, list_price, ranked, points, possible, by_scenario{<scenario_id>:{points, possible, answered, first_words_s, ai_disclosed_unprompted, reply_language, price_quoted, measures}}}], read_more }. An unknown line_id or scenario_id returns an error listing the valid ids. Vendor-run by Odile Labs (which sells After Hours and Dusklin), not independent. It does not test the caller's own line (for that, see read_more.free_line_check); to set up an After Hours line billed per answered call, see get_answering_line_offer.

{
  "type": "object",
  "properties": {
    "line_id": {
      "description": "Only this tested line, e.g. 'afterhours-plumbing', 'afterhours-vet', 'rosie', 'myaifrontdesk' or 'dialzara'. Omit for every line.",
      "type": "string",
      "maxLength": 40
    },
    "scenario_id": {
      "description": "Only this scenario: 'emergency' (leak after hours), 'booking' (book a slot), 'price' (price probe), 'disclosure' (are you real?) or 'spanish' (caller in Spanish). Omit for all.",
      "type": "string",
      "maxLength": 40
    },
    "include_evidence": {
      "default": false,
      "description": "Default false: each scenario's measures come back as strings like 'yes: <measure>'. true: measures come back as [{measure, score (0 or 1), evidence (quoted transcript)}] (much longer output).",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The live price list and limits for Odile Formats, which reformats an existing video or photos for social platforms (it does not pick clips, write captions or edit). Call it first, before estimate_media_job or prepare_upload, to learn the preset and fit names, the file limits and the job flow. Needs no sign-in, takes no arguments and changes nothing. Returns { currency, packs[{id, credits, cents}], free_credits_per_account, credits_valid_months, buy_credits_at, purchasable_through_this_connection: true, how_to_buy, units, presets{video[], photos[]} (preset name strings), fits[] (fit name strings), limits{video_source_bytes, photo_source_bytes, max_source_photos, max_trim_seconds}, flow[] }. Prices are read from the same source the website charges from.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Price an Odile Formats job in credits before anything is uploaded or charged; use it to tell the customer the cost and get their approval before unlock_job. Needs no sign-in and changes nothing. Photos are priced exactly. Reel, Feed and Square video outputs cost exactly 1 credit each; YouTube 16:9 costs 1 or 2 because the length is only known once the file is read. Returns { minimum_credits, maximum_credits, final_price_known, charge_now: 0, why }. An unknown preset or a photo count out of range returns an error naming the valid values (get_catalog lists them).

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "video",
        "photos"
      ],
      "description": "'video' for one video file, 'photos' for a set of still images."
    },
    "outputs": {
      "minItems": 1,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "reel_9x16",
          "feed_4x5",
          "square_1x1",
          "youtube_16x9",
          "post_4x5",
          "post_1x1",
          "story_9x16"
        ]
      },
      "description": "1 to 4 output preset names from get_catalog.presets (video presets for kind video, photo presets for kind photos); one finished file per preset."
    },
    "photo_count": {
      "description": "Required when kind is 'photos' (the call fails without it): how many source photos, 1 to 10. Must be omitted when kind is 'video'.",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  },
  "required": [
    "kind",
    "outputs"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The signed-in customer's Odile Formats credit balance. Use it before unlock_job to check the job is affordable, or when the customer asks what they have left. Needs a signed-in connection; takes no arguments and changes nothing. Returns { account, credits (whole number, 0 when empty), next_expiry ({ at: epoch milliseconds, credits } for the next credits to lapse, or null), buy_credits_at }. To buy more: buy_pack (needs the billing:checkout permission) returns a checkout link the customer pays on Stripe's own page, or send the customer to buy_credits_at.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

One Odile Formats job by id, or the ten most recent when no id is given. Use it to poll a job after create_media_job (every 10-20 seconds, up to 10 minutes) until state is ready or failed; if it is still rendering after that, tell the customer and check again later (nothing is charged until unlock_job). Needs a signed-in connection and changes nothing. Returns one job { job_id, kind, state (queued | rendering | ready | failed), error, unlocked, credits_cost, credits_cost_known, credits_spent, outputs[{name, preset, ready, bytes, duration}], created_at, updated_at }, or { jobs[] } of the same shape. credits_cost is final only once credits_cost_known is true. An id that is not on this account returns 'No such job'. It reports status only: the files come from get_downloads after unlock_job, and a price before uploading comes from estimate_media_job.

{
  "type": "object",
  "properties": {
    "job_id": {
      "description": "The job id (UUID) returned by create_media_job. Omit to list the ten most recent jobs.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Signed download links for every finished file of a job, once unlock_job has succeeded for it. Use it as the last step of the flow, and again whenever links have expired. Needs a signed-in connection and changes nothing. Returns { job_id, files[{name, preset, bytes, width, height, duration, url, expires_at}], how }. Each link works for 15 minutes and needs no login: fetch the files with curl (see how) rather than reading them into the conversation, or, without a shell, give the customer the links to open. Files are kept for 30 days. A job that is not unlocked returns an error with its state and cost; call unlock_job first.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The id (UUID) of a job on this account that unlock_job has already unlocked."
    }
  },
  "required": [
    "job_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Step one of an Odile Formats job: returns a 30-minute upload token and the helper command. Run the helper in a shell on the customer's machine: file bytes go straight to Odile and never enter this conversation. The helper prints the source keys to pass to create_media_job. Needs a signed-in connection with write access; nothing is charged. Returns { kind, upload_token, expires_at, helper_url, run[], accepts, part_size, note }. One video OR up to ten photos per job. Each call mints a new token; earlier tokens stay valid until their own expiry, so call it again only when a token has expired or for a new job. To price a job first use estimate_media_job; for the file limits use get_catalog.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "video",
        "photos"
      ],
      "description": "'video' to upload one MP4 or MOV (up to 500 MB, 10 minutes); 'photos' to upload 1 to 10 JPEG, PNG or WebP files."
    }
  },
  "required": [
    "kind"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Queue an Odile Formats job from sources uploaded with prepare_upload's helper. Costs nothing: credits are only spent by unlock_job, after the customer approves. One set of uploads makes exactly one job: calling it again with the same sources returns the existing job (replayed: true) whatever outputs, fit or trim are passed, so to render different outputs, upload again with prepare_upload. Needs a signed-in connection with write access. Returns at once with the job (same shape as get_job) plus replayed and next; poll get_job until state is ready.

{
  "type": "object",
  "properties": {
    "sources": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 10,
        "maxLength": 400
      },
      "description": "Source keys printed by the upload helper"
    },
    "outputs": {
      "minItems": 1,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "preset": {
            "type": "string",
            "enum": [
              "reel_9x16",
              "feed_4x5",
              "square_1x1",
              "youtube_16x9",
              "post_4x5",
              "post_1x1",
              "story_9x16"
            ],
            "description": "An output preset name from get_catalog.presets matching the source kind."
          },
          "fit": {
            "description": "How the source is fitted to the new shape: 'crop', 'blur' (blurred fill) or 'auto' (default).",
            "type": "string",
            "enum": [
              "crop",
              "blur",
              "auto"
            ]
          }
        },
        "required": [
          "preset"
        ]
      },
      "description": "1 to 4 outputs; one finished file per entry."
    },
    "trim": {
      "description": "Video only: keep just this part of the source. Omit to use the whole video.",
      "type": "object",
      "properties": {
        "start": {
          "type": "number",
          "minimum": 0,
          "description": "Start, in seconds from the beginning"
        },
        "end": {
          "type": "number",
          "maximum": 600,
          "description": "End, in seconds; at most 600"
        }
      },
      "required": [
        "start",
        "end"
      ]
    }
  },
  "required": [
    "sources",
    "outputs"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Spends the customer's credits to unlock a finished job's files. Only call once get_job says the job is ready and the customer has approved a maximum spend. Refuses, charging nothing, if the job costs more than max_credits, is not ready, or the balance is short (the error says which, with the amount needed). A job that is already unlocked comes back as it is, with no charge and no balance or max_credits check. Needs a signed-in connection with spend access. Returns the job (same shape as get_job, with unlocked: true) plus credits_left and next: 'get_downloads'.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The id (UUID) of a ready job on this account."
    },
    "max_credits": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "The most the customer agreed to spend on this job, 1 to 100 credits. The unlock is refused, charging nothing, if the job costs more."
    }
  },
  "required": [
    "job_id",
    "max_credits"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns a one-time Stripe checkout link for a prepaid pack; the customer opens it and pays on Stripe's own page, and this connection never sees the card. Only call it when the customer asked to buy, and tell them the price first. Products: 'formats' (Odile Formats credits; packs from get_catalog), 'minutes' (meeting minutes, only where Meeting Notes is on), 'calls' (answered calls for one of the customer's own After Hours lines; line_id required: calls10: 10 calls for $15; calls50: 50 calls for $75). What was paid is added within a minute of payment, whatever device paid it. Nothing renews. Needs a signed-in connection with the billing:checkout permission. Returns { checkout_url, product, pack, price_cents, units, unit, then }.

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string",
      "enum": [
        "formats",
        "minutes",
        "calls"
      ],
      "description": "'formats' credits, meeting 'minutes', or answered 'calls' for a line."
    },
    "pack": {
      "type": "string",
      "maxLength": 20,
      "description": "The pack id: formats small | medium | large; minutes m200 | m600 | m2000; calls calls10 | calls50."
    },
    "line_id": {
      "description": "For product 'calls' only: the line_id from get_answering_line.",
      "type": "string",
      "maxLength": 64
    }
  },
  "required": [
    "product",
    "pack"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}