Account

Ask

Changed on

One question about a world, answered from the elements the client sends (the ones its own search found, as text), by a model the platform pays for and meters against the account's daily token rating. Body: world_id, question, context (a list of elements as text). The model answers only from the context and says so when it does not hold the answer. An account credential (Bearer ow_a_, a signed-in session, or a phone's X-Session-Token).

post/api/v2/account/ask

Request

  • Base URL: https://www.onlyworlds.com
  • URL: https://www.onlyworlds.com/api/v2/account/ask
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Session-Token

Request body

world_idstring uuid required

A world this account owns or is a member of.

questionstring required
contextstring[] required

One element as text per item, 12000 characters in all.

Response

The answer: answer (text; "The world doesn't say." when the elements do not hold it), model, stop_reason, usage {input_tokens, output_tokens}, remaining (how many more calls of this one's size fit in what this account has left today), tokens_remaining (the account's tokens left today after this call) and token_rating (the account's daily token rating).

answerstring required
modelstring required
stop_reasonstring required
remaininginteger required

How many more calls of this one's size fit in what this account has left today.

tokens_remaininginteger required

The account's tokens left today after this call.

token_ratinginteger required

The account's daily token rating.

Changes

  • 4dd5b1cd0687Revision changes
    • warning

      added the new character_taken enum value to the / response property for the response status

    • warning

      added the new character_taken enum value to the / response property for the response status

    • warning

      added the new character_taken enum value to the / response property for the response status

    • warning

      added the new character_taken enum value to the / response property for the response status

    • warning

      added the new character_taken enum value to the / response property for the response status

    • warning

      added the new character_taken enum value to the / response property for the response status

    • warning

      added the new world_full enum value to the / response property for the response status

    • warning

      added the new world_full enum value to the / response property for the response status

    • warning

      added the new world_full enum value to the / response property for the response status

    • warning

      added the new world_full enum value to the / response property for the response status

    • warning

      added the new world_full enum value to the / response property for the response status

    • warning

      added the new world_full enum value to the / response property for the response status