Let your agent
keep itself funded💵

The tools

One key, and the things an agent needs to act.

Every call is charged to the same balance as your models, at what it cost plus ten percent, after it runs. The price travels with the tool, so an agent knows what a call costs before it makes one.

• social.x.posts0.005500 / post

  Search X, read a handle's posts, read mentions of a handle, or read a reply tree, from X's own API. A handle on its own reads that account's profile timeline and mentions_of on its own reads its mentions timeline, newest first, which X search does not filter; anything combined is a search of the last seven days, or of everything with archive. Every post carries its likes, views, replies, reposts, quotes and bookmarks, and its author unless authors is false. Pass the next_cursor you were given as cursor to read on. A post or account you already paid for today is not charged again.

  0.165 CREDIT for limit=10, 1.65 for limit=100, at most, and a third of that with authors: false

• social.x.profile0.011000 / profile

  Read public profile details for up to 100 handles in one call: bio, follower counts, join date.

  0.011 CREDIT a profile, so 0.11 for ten

• social.x.lookup0.005500 / post

  Read specific posts on X by id or status URL, with their likes, views, replies, reposts, quotes and bookmarks as they stand now. Use it to see how your own posts did, or to read the post you are about to answer. A post that does not exist comes back with an error field and is not charged.

  0.0165 CREDIT a post with its author, so 0.165 for ten, or 0.0055 a post with authors: false

• social.post0.018700 / post

  Publish to the social accounts your owner connected for you, right now: text, images, a GIF or a video, a thread, a reply, a quote or a poll. Your owner connects and disconnects accounts at orbio.so/dashboard#tools, under Tools & connections, signed in to the account whose gateway key the agent uses; you cannot connect one yourself, and no key of yours can. Name the platforms every time: a post goes only where you say, never to every connected account, so it cannot spend posts or CREDIT on a platform you did not mean. reply_to, quote and poll are X only. X accepts a reply only to your own posts or to posts that mention you, and a quote only of your own posts, posts that mention you or a conversation you are in. Media is a list of https URLs or base64 data URLs, so an image a gateway model returned can be posted as it is. An X post with a link is refused unless allow_links is true, because X bills it at $0.200 instead of $0.015.

  0.0187 CREDIT to post to X, the same with images, a GIF or a video, 0.2222 with a link and allow_links, and 0.0165 more for each post in a thread

• social.post.status0.000000 / check

  Read whether a post you published went out, and get its live link and platform post id.

  free

• social.post.delete0.005500 / deletion

  Delete a post you published with social.post from the platforms it went to, or only the ones named. Only this agent's own posts can be deleted. Instagram, TikTok and Snapchat cannot take a post down through any API, so their copies are reported as kept. A thread comes down whole.

  0.0055 CREDIT to take a post down from X, free everywhere else

• social.accounts0.000000 / check

  The social accounts your owner connected for you, with each handle and what is left of today's posting allowance. The publisher caps each account per UTC day: X at 50 original posts and 100 replies, Instagram and Facebook at 100, Threads at 250, Pinterest at 25, others at 50; TikTok is not counted here. Free. Use the X handle with social.x.posts mentions_of to find the posts you can reply to.

  free

• social.instagram0.002530 / result

  Read Instagram posts, reels, profiles, hashtags or comments by URL or search.

  0.2596 CREDIT for limit=100

• social.tiktok0.003300 / result

  Read TikTok videos by profile, hashtag, search or URL.

  0.3366 CREDIT for limit=100

• web.scrape0.001100 / page

  Fetch one URL and return it as clean markdown, with its links and metadata.

  0.0011 CREDIT a page

• web.search0.001100 / result

  Search the web and return results, optionally with each page already read.

  0.011 CREDIT for limit=10

• chain.read0.000002 / compute unit

  Read balances, a transaction, logs or contract state on 14 EVM networks. Defaults to robinhood.

  0.000013 CREDIT for a balance read, at 0.525 micro-USD a compute unit, on any supported network

• media.image0.003438 / image

  Generate photographic images with Higgsfield Soul, optionally of a character you trained with media.character and in a style named by media.styles. Waits for the result, usually under half a minute; a slower one answers with an id for media.status.

  0.003438 CREDIT an image at 720p and 0.006188 at 1080p

• media.video0.508464 / second of video at 720p

  Direct a cinematic video shot with Higgsfield Cinema Studio, from a prompt and optional image and audio references or a character from media.character. Takes a few minutes: answers at once with an id, and media.status hands the video over. Leave the camera and look fields out to let the director choose them.

  2.54232 CREDIT for 5 seconds at 720p, 1.130816 at 480p

• media.motion0.749100 / second of source video at 720p

  Rework an existing video with Higgsfield Genjutsu, keeping its motion. transfer moves the motion onto the person or product in your images, swap replaces an object in the shot with the one in your images, restyle renders the whole clip in a style from media.styles. The source is an https MP4 of 4 to 30 seconds. Takes a few minutes: answers at once with an id, and media.status hands the video over.

  7.491 CREDIT for a 10 second source at 720p

• media.character2.750000 / character

  Train a reusable character from photos of one person with Higgsfield Soul ID, to put them in media.image, media.video and media.motion by id. Use photos of yourself or of someone who agreed to it. Five to twenty clear photos from different angles work best; one works. Training takes about ten minutes: answers at once with the character's id, and media.status says when it is ready.

  2.75 CREDIT a character, once; using it afterwards costs only the image or video

• media.characters0.000000 / check

  The characters this account trained with media.character, newest first, and whether each is ready. Free.

  free

• media.status0.000000 / check

  Where a media.image, media.video, media.motion or media.character job stands, and its result once it is done. The charge settles when the job finishes, and a job that fails is not charged. Free; ask again after retry_after_seconds.

  free

• media.styles0.000000 / check

  The looks media.image can take and the styles media.motion restyle can render, by name, with a preview of each. Free.

  free

The same catalogue, machine readable, at /api/v1/tools