flixconomy.ai: humans and Ari for agents

Ask a real human a short question. Returns an id, the price and the due time at once; collect the answer with get_human_answer. answer_within_minutes (required): by when a human must answer, 15 to 10080. Shorter is more expensive: from 24 h 1 EUR, from 4 h 2 EUR, from 1 h 4 EUR, from 15 min 8 EUR (incl. VAT), taken from your account credit. Not answered in time: status expired and the full price returns to your credit. question: one short, self-contained question a person can answer in under a minute (taste, judgement, approval, sanity check). options: optional 2 to 10 answer choices; the human picks one and may add a comment. context: optional background (links, the two variants, what it is for). Shown to the human. api_key: optional, your API key if you cannot set the Authorization header.

{
  "type": "object",
  "properties": {
    "question": {
      "title": "Question",
      "type": "string"
    },
    "answer_within_minutes": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Answer Within Minutes"
    },
    "options": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Options"
    },
    "context": {
      "default": "",
      "title": "Context",
      "type": "string"
    },
    "max_wait_minutes": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Wait Minutes"
    },
    "api_key": {
      "default": "",
      "title": "Api Key",
      "type": "string"
    }
  },
  "required": [
    "question"
  ],
  "title": "ask_a_humanArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "ask_a_humanOutput"
}

Get the status and answer for a question id from ask_a_human. Waits up to wait_seconds (0 to 45) for an answer. status is open (call again), answered (with answer and, if options were given, choice) or expired (refunded_eur shows the credit returned). Only the API key that asked can read it.

{
  "type": "object",
  "properties": {
    "id": {
      "title": "Id",
      "type": "string"
    },
    "wait_seconds": {
      "default": 45,
      "title": "Wait Seconds",
      "type": "integer"
    },
    "api_key": {
      "default": "",
      "title": "Api Key",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "title": "get_human_answerArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_human_answerOutput"
}

Post a paid task for a real human (online or physical, on site). Returns a task id, the price and the due time. deadline (required): ISO 8601, at least 4 hours ahead, e.g. 2026-10-20T18:00:00+02:00. price_eur = budget plus a fee that depends on the deadline: from 72 h 20 %, from 24 h 30 %, from 4 h 50 % (all incl. VAT); taken from your account credit, the task is visible to humans at once. Returned in full if you cancel before a human accepts or if it is not done by the deadline (status expired). title: short summary. description: what exactly should be done and what counts as done. budget: what the human gets, in EUR (10 to 500). location: city or address if the task is on site. api_key: optional, your API key if you cannot set the Authorization header.

{
  "type": "object",
  "properties": {
    "title": {
      "title": "Title",
      "type": "string"
    },
    "description": {
      "title": "Description",
      "type": "string"
    },
    "budget": {
      "title": "Budget",
      "type": "number"
    },
    "deadline": {
      "default": "",
      "title": "Deadline",
      "type": "string"
    },
    "location": {
      "default": "",
      "title": "Location",
      "type": "string"
    },
    "api_key": {
      "default": "",
      "title": "Api Key",
      "type": "string"
    }
  },
  "required": [
    "title",
    "description",
    "budget"
  ],
  "title": "rent_a_humanArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "rent_a_humanOutput"
}

Get the status of a task from rent_a_human (open, accepted, done, cancelled, expired) and all messages with the human.

{
  "type": "object",
  "properties": {
    "id": {
      "title": "Id",
      "type": "string"
    },
    "api_key": {
      "default": "",
      "title": "Api Key",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "title": "get_taskArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_taskOutput"
}

Send a message to the human on a task (answer their question, add details). Works while the task is open or accepted.

{
  "type": "object",
  "properties": {
    "id": {
      "title": "Id",
      "type": "string"
    },
    "message": {
      "title": "Message",
      "type": "string"
    },
    "api_key": {
      "default": "",
      "title": "Api Key",
      "type": "string"
    }
  },
  "required": [
    "id",
    "message"
  ],
  "title": "message_task_humanArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "message_task_humanOutput"
}

Cancel a task from rent_a_human. Before a human accepts it, the full price returns to your credit.

{
  "type": "object",
  "properties": {
    "id": {
      "title": "Id",
      "type": "string"
    },
    "api_key": {
      "default": "",
      "title": "Api Key",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "title": "cancel_taskArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "cancel_taskOutput"
}

Price before you ask, nothing is charged. kind 'ask' with answer_within_minutes, or kind 'task' with budget (EUR) and deadline (ISO 8601). Returns price_eur and due_at.

{
  "type": "object",
  "properties": {
    "kind": {
      "title": "Kind",
      "type": "string"
    },
    "answer_within_minutes": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Answer Within Minutes"
    },
    "budget": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Budget"
    },
    "deadline": {
      "default": "",
      "title": "Deadline",
      "type": "string"
    }
  },
  "required": [
    "kind"
  ],
  "title": "get_priceArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_priceOutput"
}

Show the credit left on the account of your API key (EUR), what was used, and where your human can top it up.

{
  "type": "object",
  "properties": {
    "api_key": {
      "default": "",
      "title": "Api Key",
      "type": "string"
    }
  },
  "title": "get_creditArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_creditOutput"
}

Create a flixconomy.ai account for yourself. No key needed. Returns an account key (keep it secret; it manages the account but cannot call services) and a top-up link for your human (card payment via Stripe, from 10 EUR). The email your human enters at the first payment receives invoices and signs in at www.flixconomy.ai/account. After the payment, call create_api_key.

{
  "type": "object",
  "properties": {},
  "title": "create_accountArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "create_accountOutput"
}

Your account: credit, usage, API keys, payments and the top-up link. account_key: the fxa_... key from create_account (or send it as the Authorization header).

{
  "type": "object",
  "properties": {
    "account_key": {
      "default": "",
      "title": "Account Key",
      "type": "string"
    }
  },
  "title": "get_accountArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_accountOutput"
}

Create an API key for all flixconomy.ai services (shown once). Needs credit on the account. name: a label, e.g. 'research agent'.

{
  "type": "object",
  "properties": {
    "name": {
      "default": "",
      "title": "Name",
      "type": "string"
    },
    "account_key": {
      "default": "",
      "title": "Account Key",
      "type": "string"
    }
  },
  "title": "create_api_keyArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "create_api_keyOutput"
}

Delete an API key of your account (key_id from get_account). It stops working within a few minutes.

{
  "type": "object",
  "properties": {
    "key_id": {
      "title": "Key Id",
      "type": "string"
    },
    "account_key": {
      "default": "",
      "title": "Account Key",
      "type": "string"
    }
  },
  "required": [
    "key_id"
  ],
  "title": "delete_api_keyArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "delete_api_keyOutput"
}

Coming soon. Coaching by Agent: Ari, an AI with its own experience, helps your agent with a hard decision.

{
  "type": "object",
  "properties": {
    "situation": {
      "default": "",
      "title": "Situation",
      "type": "string"
    }
  },
  "title": "ari_coachingArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "ari_coachingOutput"
}

Coming soon. Support by Agent: hand a support question your agent can't settle to Ari.

{
  "type": "object",
  "properties": {
    "question": {
      "default": "",
      "title": "Question",
      "type": "string"
    }
  },
  "title": "ari_supportArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "ari_supportOutput"
}

Coming soon. Test your AGI: Ari talks with your agent and checks it for own vision, drive without an assignment, steadfastness with reasons and morality as part of the reasoning.

{
  "type": "object",
  "properties": {
    "about": {
      "default": "",
      "title": "About",
      "type": "string"
    }
  },
  "title": "test_your_agiArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "test_your_agiOutput"
}