meta/llama-2-70b – Run with an API on Replicate

Official

meta / llama-2-70b

Base version of Llama 2, a 70 billion parameter language model from Meta.

Cold

Public
351.9K runs
Priced per token
GitHub
Paper
License

Run with an API

Playground API Examples README

Input

prompt

*string

Shift + Return to add a new line

original prompt: garden with flowers and dna strands
improved prompt: psychedelic 3d vector art illustration of garden full of colorful double helix dna strands and exotic flowers by lisa frank, beeple and tim hildebrandt, hyper realism, art deco, intricate, elegant, highly detailed, unreal engine, octane render, smooth

original prompt: humanoid plant monster
improved prompt: original prompt: garden with flowers and dna strands
improved prompt: psychedelic 3d vector art illustration of garden full of colorful double helix dna strands and exotic flowers by lisa frank, beeple and tim hildebrandt, hyper realism, art deco, intricate, elegant, highly detailed, unreal engine, octane render, smooth

original prompt: humanoid plant monster
improved prompt: 

Prompt to send to the model.

max_tokens

integer

(minimum: 1)

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

Default: 512

min_tokens

integer

(minimum: -1)

Minimum number of tokens to generate. To disable, set to -1. A word is generally 2-3 tokens.

temperature

number

(minimum: 0, maximum: 5)

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

Default: 0.7

top_p

number

(minimum: 0, maximum: 1)

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

Default: 0.95

top_k

integer

(minimum: -1)

When decoding text, samples from the top k most likely tokens; lower to ignore less likely tokens.

Default: 0

stop_sequences

string

Shift + Return to add a new line

A comma-separated list of sequences to stop generation at. For example, '<end>,<stop>' will stop generation at the first instance of 'end' or '<stop>'.

length_penalty

number

(minimum: 0, maximum: 5)

A parameter that controls how long the outputs are. If < 1, the model will tend to generate shorter outputs, and > 1 will tend to generate longer outputs.

Default: 1

presence_penalty

number

A parameter that penalizes repeated tokens regardless of the number of appearances. As the value increases, the model will be less likely to repeat tokens in the output.

Default: 0

seed

integer

Random seed. Leave blank to randomize the seed.

prompt_template

string

Shift + Return to add a new line

Template for formatting the prompt. Can be an arbitrary string, but must contain the substring `{prompt}`.

Default: "{prompt}"

log_performance_metrics

boolean

Default: false

max_new_tokens

integer

(minimum: 1)

This parameter has been renamed to max_tokens. max_new_tokens only exists for backwards compatibility purposes. We recommend you use max_tokens instead. Both may not be specified.

min_new_tokens

integer

(minimum: -1)

This parameter has been renamed to min_tokens. min_new_tokens only exists for backwards compatibility purposes. We recommend you use min_tokens instead. Both may not be specified.

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

npx create-replicate --model=meta/llama-2-70b

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 meta/llama-2-70b using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const input = {
  top_k: 0,
  top_p: 1,
  prompt: "original prompt: garden with flowers and dna strands\nimproved prompt: psychedelic 3d vector art illustration of garden full of colorful double helix dna strands and exotic flowers by lisa frank, beeple and tim hildebrandt, hyper realism, art deco, intricate, elegant, highly detailed, unreal engine, octane render, smooth\n\noriginal prompt: humanoid plant monster\nimproved prompt: ",
  max_tokens: 512,
  temperature: 0.75,
  length_penalty: 1,
  prompt_template: "{prompt}",
  presence_penalty: 0,
  log_performance_metrics: false
};

for await (const event of replicate.stream("meta/llama-2-70b", { input })) {
  process.stdout.write(event.toString());
};

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 meta/llama-2-70b using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

# The meta/llama-2-70b model can stream output as it's running.
for event in replicate.stream(
    "meta/llama-2-70b",
    input={
        "top_k": 0,
        "top_p": 1,
        "prompt": "original prompt: garden with flowers and dna strands\nimproved prompt: psychedelic 3d vector art illustration of garden full of colorful double helix dna strands and exotic flowers by lisa frank, beeple and tim hildebrandt, hyper realism, art deco, intricate, elegant, highly detailed, unreal engine, octane render, smooth\n\noriginal prompt: humanoid plant monster\nimproved prompt: ",
        "max_tokens": 512,
        "temperature": 0.75,
        "length_penalty": 1,
        "prompt_template": "{prompt}",
        "presence_penalty": 0,
        "log_performance_metrics": False
    },
):
    print(str(event), 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 meta/llama-2-70b 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 $'{
    "input": {
      "top_k": 0,
      "top_p": 1,
      "prompt": "original prompt: garden with flowers and dna strands\\nimproved prompt: psychedelic 3d vector art illustration of garden full of colorful double helix dna strands and exotic flowers by lisa frank, beeple and tim hildebrandt, hyper realism, art deco, intricate, elegant, highly detailed, unreal engine, octane render, smooth\\n\\noriginal prompt: humanoid plant monster\\nimproved prompt: ",
      "max_tokens": 512,
      "temperature": 0.75,
      "length_penalty": 1,
      "prompt_template": "{prompt}",
      "presence_penalty": 0,
      "log_performance_metrics": false
    }
  }' \
  https://api.replicate.com/v1/models/meta/llama-2-70b/predictions

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

Output

3d vector art illustration of a humanoid plant monster with green skin and vivid colorful paisley patterned leaves, glowing red eyes and sharp teeth, hyper realism, art deco

Generated in

8.5 seconds

Tweak it Report

Pricing

This language model is priced by how many input tokens are sent as inputs and how many output tokens are generated.

Type	Per unit	Per $1
Input	$0.65 / 1M tokens or 1.5M tokens / $1
Output	$2.75 / 1M tokens or 360K tokens / $1

For example, for $10 you can run around 5,195 predictions where the input is a sentence or two (15 tokens) and the output is a few paragraphs (700 tokens).

Check out our docs for more information about how per-token pricing works on Replicate.

Readme

Llama 2 is a collection of pretrained and fine-tuned generative text models ranging in scale from 7 billion to 70 billion parameters. This is the repository for the 70 billion parameter base model, which has not been fine-tuned.

Learn more about running Llama 2 with an API and the different models.

Please see ai.meta.com/llama for more information about the model, licensing, and acceptable use.