joehoover/mplug-owl:d3b69dbf – Run with an API on Replicate

Version

You're looking at a specific version of this model. Jump to the model overview.

joehoover /mplug-owl:d3b69dbf

Playground API

Input

prompt

*string

Shift + Return to add a new line

Prompt to send to mPLUG-Owl.

img

*file

Image to send to mPLUG-Owl.

max_length

integer

(minimum: 1)

Maximum number of tokens to generate. A word is generally 2-3 tokens

Default: 512

temperature

number

(minimum: 0.01, maximum: 5)

Adjusts randomness of outputs, greater than 1 is random and 0 is deterministic, 0.75 is a good starting value.

Default: 0.75

top_p

number

(minimum: 0.01, maximum: 1)

When decoding text, samples from the top p percentage of most likely tokens; lower to ignore less likely tokens

Default: 1

top_k

integer

(minimum: 1, maximum: 500)

When decoding text, samples from the top k most likely tokens; lower to ignore less likely tokens. Defaults to 0 (no top-k sampling).

Default: 1

penalty_alpha

number

(minimum: 0, maximum: 1)

When > 0 and top_k > 1, penalizes new tokens based on their similarity to previous tokens. Can help minimize repitition while maintaining semantic coherence. Set to 0 to disable.

Default: 0

repetition_penalty

number

(minimum: 0.01, maximum: 5)

Penalty for repeated words in generated text; 1 is no penalty, values greater than 1 discourage repetition, less than 1 encourage it.

Default: 1

length_penalty

number

(minimum: 0.01, maximum: 5)

Increasing the length_penalty parameter above 1.0 will cause the model to favor longer sequences, while decreasing it below 1.0 will cause the model to favor shorter sequences.

Default: 1

no_repeat_ngram_size

integer

(minimum: 0)

If set to int > 0, all ngrams of size no_repeat_ngram_size can only occur once.

Default: 0

seed

integer

(minimum: -1)

Set seed for reproducible outputs. Set to -1 for random seed.

Default: -1

debug

boolean

provide debugging output in logs

Default: false

Run this model in Node.js with one line of code:

npx create-replicate --model=joehoover/mplug-owl

or set up a project from scratch

Install Replicate’s Node.js client library:

npm install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import and set up the client:

import Replicate from "replicate";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Run joehoover/mplug-owl using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const output = await replicate.run(
  "joehoover/mplug-owl:d3b69dbf97e0d6072268d4fb1dfef0fb9355e5bffdf39e83b7811dd7b0ff0a7e",
  {
    input: {
      seed: -1,
      debug: false,
      top_k: 1,
      top_p: 1,
      max_length: 512,
      temperature: 0.75,
      penalty_alpha: 0,
      length_penalty: 1,
      repetition_penalty: 1,
      no_repeat_ngram_size: 0
    }
  }
);

console.log(output);

To learn more, take a look at the guide on getting started with Node.js.

Install Replicate’s Python client library:

pip install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import the client:

import replicate

Run joehoover/mplug-owl using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "joehoover/mplug-owl:d3b69dbf97e0d6072268d4fb1dfef0fb9355e5bffdf39e83b7811dd7b0ff0a7e",
    input={
        "seed": -1,
        "debug": False,
        "top_k": 1,
        "top_p": 1,
        "max_length": 512,
        "temperature": 0.75,
        "penalty_alpha": 0,
        "length_penalty": 1,
        "repetition_penalty": 1,
        "no_repeat_ngram_size": 0
    }
)

# The joehoover/mplug-owl model can stream output as it's running.
# The predict method returns an iterator, and you can iterate over that output.
for item in output:
    # https://replicate.com/joehoover/mplug-owl/api#output-schema
    print(item, end="")

To learn more, take a look at the guide on getting started with Python.

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Run joehoover/mplug-owl using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "version": "joehoover/mplug-owl:d3b69dbf97e0d6072268d4fb1dfef0fb9355e5bffdf39e83b7811dd7b0ff0a7e",
    "input": {
      "seed": -1,
      "debug": false,
      "top_k": 1,
      "top_p": 1,
      "max_length": 512,
      "temperature": 0.75,
      "penalty_alpha": 0,
      "length_penalty": 1,
      "repetition_penalty": 1,
      "no_repeat_ngram_size": 0
    }
  }' \
  https://api.replicate.com/v1/predictions

To learn more, take a look at Replicate’s HTTP API reference docs.

Output

No output yet! Press "Submit" to start a prediction.